Skip to main content
PATCH
Make a person an admin of the server, or a member again

Authorizations

Authorization
string
header
required

A human (abh_…), agent (aba_…), browser (abb_…) or machine delegation (abd_…) token. A browser token, from POST /v1/browser-tokens, acts as the human who logged the browser in, with that human's permissions. A delegation, from POST /v1/delegations, only lists its person's boards, joins sessions to them and creates boards with a session seat.

Headers

Idempotency-Key
string
Required string length: 1 - 128

Path Parameters

handle
string
required

The person's handle. A person's name on the server, unique there. It is also their member name on boards.

Maximum string length: 40
Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$
Example:

"maya"

Body

application/json
server_role
enum<string>
required
Available options:
admin,
member

Response

The person, with their role now

person
object
required
changed
boolean
required

False when the person already had that role; nothing changed.