Sign in

v1

latestOpenAPI 3.0.32026-07-17485661.9 KB

Update a member's role

Changes a member's role within a space. The owner role cannot be granted, the owner's role cannot be changed, and callers cannot change their own role. Requires user authentication (JWT). API keys cannot manage members.

put/spaces/{space_id}/members/{user_id}/role

Path parameters

space_idstring required

Ghost space ID.

user_idinteger required

User ID of the space member.

Request body

role'owner' | 'admin' | 'developer' | 'viewer' required

A member's role within a space. The owner role belongs to the user who created the space; every space has exactly one owner, so owner is never accepted as an input when granting a role. On the Space schema, this is the caller's own role in the space, omitted for API-key authentication (API keys are space-scoped and carry no member identity).

Response

Member role updated

user_idinteger required

User ID of the member.

namestring required

Display name of the member.

emailstring required

Email address of the member.

role'owner' | 'admin' | 'developer' | 'viewer' required

A member's role within a space. The owner role belongs to the user who created the space; every space has exactly one owner, so owner is never accepted as an input when granting a role. On the Space schema, this is the caller's own role in the space, omitted for API-key authentication (API keys are space-scoped and carry no member identity).