PUT
/
workspaces
/
{workspace_id}
/
invitations
/
{invitation_id}
curl --request PUT \
  --url https://app.getcensus.com/api/v1/workspaces/{workspace_id}/invitations/{invitation_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "role": "owner"
}'
{
  "status": "updated",
  "data": {
    "id": 90967,
    "email": "newuser@example.com",
    "created_at": "2023-09-22T20:25:45.185Z",
    "created_by_id": 13,
    "claimed_at": "2023-09-22T20:25:45.185Z",
    "claimed_by_id": 11,
    "role": "admin",
    "associated_workspace_invitations": [
      {
        "id": 90967,
        "workspace_id": 1234,
        "role": "Viewer"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authorization using your Personal Access Token. Generate a new PAT on your user settings page.

Path Parameters

​
workspace_id
integer
required

ID of the workspace

​
invitation_id
integer
required

ID of the invitation

Body

application/json
​
role
enum<string>

The new role to be associated with this invitation that will be applied to the user once the invite is claimed.

Available options:
owner,
editor,
operator,
viewer
Example:

"owner"

Response

200
application/json
Successfully updated workspace invitation role.
​
status
enum<string>
required

The outcome of the update request

Available options:
updated
Example:

"updated"

​
data
object
required

Was this page helpful?

Raise issue
List workspace invitationsRevoke workspace invitation