Invitations · listInvitations
List invitations
GET /v1/workspaces/{id}/invitations
Owners only. The workspace's invitations, pending ones first.
- Who may call it
- humans: Owners and up
- Server
- https://api.logu.dev
Parameters#
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | required | The workspace's id (wsp_…). The request acts in this workspace (the Logu-Workspace header is ignored). · e.g. wsp_01K7D7Y8Z0B2D4F6H8K0M2P4R6 |
Example#
curl -s "https://api.logu.dev/v1/workspaces/wsp_01K7D7Y8Z0B2D4F6H8K0M2P4R6/invitations" \
-H "Authorization: Bearer $LOGU_SESSION_TOKEN"
Responses#
200
Invitations.
{
"invitations": [
{
"id": "inv_01K7DB4D6F8H0K2M4P6R8T0V2X",
"email": "carla@example.com",
"role": "viewer",
"status": "pending",
"invitedBy": {
"id": "Xq3bY7tLmN2pR8sV",
"name": "Ana"
},
"expiresAt": "2026-10-19T14:03:11.000Z",
"createdAt": "2026-10-12T14:03:11.000Z"
}
]
}
Response fields
| Field | Type | Required | Notes |
|---|---|---|---|
invitations | Invitation[] | required | |
invitations[].id | string | required | |
invitations[].email | string | required | |
invitations[].role | "owner" | "decider" | "viewer" | required | |
invitations[].status | "pending" | "accepted" | "revoked" | "expired" | required | |
invitations[].invitedBy | MemberRef | null | required | |
invitations[].invitedBy.id | string | required | |
invitations[].invitedBy.name | string | required | |
invitations[].expiresAt | string | required | date-time |
invitations[].createdAt | string | required | date-time |
Errors#
Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.
| Status | Code | Meaning |
|---|---|---|
| 401 | unauthorized | No credentials, or the API key or session is invalid or revoked. |
| 403 | forbidden | The caller is authenticated but may not do this (wrong role, or an API key on a human-only endpoint). |
| 404 | not_found | No such route, or the resource doesn't exist in your workspace. |
| 500 | internal_error | Something went wrong on Logu's side. |