Developers API reference Version 1 · generated from the code openapi.json
Routes

organisation

Change the role of members

POST /api/v1/organisation/members/role

Give one root role to several members, or take it back with none. The last admin is never demoted; partial says some of the ids were skipped.

Required scope: org:admin

Request body application/json

  • ids array of integer · required

    Ids of the members.

  • role string · required

    The root role to give them; none takes it back.

Response

200 MembersRoleDone

  • changed integer

    Number of members whose role changed.

  • partial boolean

    Whether some of the ids were skipped.

Errors

  • 401

    No valid credential.

  • 403

    The credential lacks the required scope, or the account may not do this.

  • 409

    The current state of the content forbids the request.

  • 422

    A value is missing or malformed.

  • 429

    Too many requests; Retry-After gives the seconds to wait.

planner_banner_ad_pt