Update Invite Role

Change the role on a pending (not yet accepted) invite. Admin only.

Updates the role the invitee will receive when they accept. Only pending invites can be updated — attempting to update an accepted, revoked, or expired invite returns 409. The invitee is not notified of the role change; the updated role takes effect when they accept.

Authentication

AuthorizationBearer

Clerk JWT token

Path parameters

ws_idstringRequiredformat: "uuid"

invite_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

roleenumRequired

New role to assign: admin, editor, or viewer.

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

$	curl -X PATCH https://api.onepin.ai/api/v1/workspaces/ws_id/invites/invite_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"role": "editor"
>	}'

1	{
2	"data": {
3	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4	"email": "invitee@example.com",
5	"role": "editor",
6	"status": "pending",
7	"expires_at": "2024-01-29T09:30:00Z",
8	"invited_by": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
9	"created_at": "2024-01-15T09:30:00Z"
10	},
11	"meta": {
12	"request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
13	"timestamp": "2024-01-15T09:30:00Z"
14	}
15	}