Members

Update a member role

PATCH/v1/workspaces/{workspaceId}/members/{memberId}

Changes a member's role. Requires an admin key. The last admin cannot become a viewer or editor.

Authentication

Send your Spark API key with every request. The value is the full bearer token Spark returned when you created the key. See Authentication.

Authorization: Bearer <SPARK_API_KEY>

Path parameters

workspaceId

string

The workspace id.

memberId

string

The membership id.

Request body

role

string

New role for the member. One of: viewer, editor, admin.

Was this page helpful?

curl --request PATCH \
  --url "https://api.spark.graphon.ai/v1/workspaces/wspQ7WsH2Np5L/members/memA1b2C3d4E5" \
  --header "Authorization: Bearer $SPARK_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"role":"editor"}'

Response

JSON

{
  "id": "memA1b2C3d4E5",
  "workspaceId": "wspQ7WsH2Np5L",
  "userId": "usrB2c3D4e5F6",
  "displayName": "Ada Lovelace",
  "email": "ada@example.com",
  "role": "admin",
  "status": "active",
  "joinedAt": "2026-09-14T18:00:00.000Z",
  "revision": 1
}