Skip to main content
GET
/
open
/
workspaces
/
{workspaceId}
/
invites
List Workspace Invites
curl --request GET \
  --url https://api.opnform.com/open/workspaces/{workspaceId}/invites \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 123,
    "email": "jsmith@example.com",
    "valid_until": "2023-11-07T05:31:56Z"
  }
]

​
List Workspace Invites

Retrieve all pending or accepted invitations for a workspace.

​
Authentication & Scope

Requires workspace admin access. For Personal Access Tokens, the token must include the workspaces-write ability and the token owner must be an admin of the workspace. Non-admin workspace members and tokens with only workspace-users-read cannot list invites.

​
Request

GET /open/workspaces/{workspaceId}/invites HTTP/1.1
Host: api.opnform.com
Authorization: Bearer <token>

​
Path Parameters

ParameterTypeDescription
workspaceIdnumberID of the workspace.

​
Response

200 OK – Array of Invite objects. 
[
  {
    "id": 55,
    "email": "invitee@example.com",
    "role": "user",
    "status": "pending",
    "valid_until": "2024-06-25T23:59:59Z"
  }
]
403 Forbidden – You are not a workspace admin, or your token lacks workspaces-write.

Authorizations

​
Authorization
string
header
required

Personal Access Token

Path Parameters

​
workspaceId
string
required

Response

Successful

​
id
number
​
email
string<email>
​
role
enum<string>
Available options:
admin,
user,
readonly
​
status
enum<string>
Available options:
pending,
accepted
​
valid_until
string<date-time>

Expiration timestamp for the invite