staqlydocs
REST APIAPI referenceAccounts

Change a member's role

Change a member's role (admins up to admin; owners any role)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

PATCH
/v1/members/{user_id}

Signed-in people only (not API keys). The last owner and the account owner keep the owner role (409).

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Path Parameters

user_id*string

Header Parameters

Idempotency-Key?string

Replays the stored response when the same key is repeated with the same method, path, query string and body within 24 hours (422 idempotency_mismatch with a different request, 409 idempotency_in_progress while the first one runs). Not applied to multipart uploads or to responses that carry a secret.

Lengthlength <= 200

Request Body

application/json
  1. body
role*Role

viewer: read; editor: write, schedule and publish; admin: everything in the workspace; owner: admin who may also manage owners

Value in"owner""admin""editor""viewer"

Response Body

OK

application/json
  1. response
user_id*string
name*string
email*string
avatar_url*string
role*Role

viewer: read; editor: write, schedule and publish; admin: everything in the workspace; owner: admin who may also manage owners

Value in"owner""admin""editor""viewer"
account_owner*boolean
you*boolean
created_at*string
curl -X PATCH 'https://staqly.example.com/v1/members/string' \  -H 'Content-Type: application/json' \  -d '{  "role": "owner"}'
{  "user_id": "string",  "name": "string",  "email": "string",  "avatar_url": "string",  "role": "owner",  "account_owner": true,  "you": true,  "created_at": "string"}