Members

Change a member's account role

Changes a member's account_role between ADMIN and MEMBER.

  • OWNER: not an assignable value here. An account has exactly one owner, and ownership is handed over only through PUT /v1/accounts/{account_id}/owner, which promotes the new owner and steps the current one down in the same operation.
  • Last owner: the account's last OWNER cannot be demoted.
patch/v1/accounts/{account_id}/members/{member_id}

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/accounts/{account_id}/members/{member_id}
  • Auth: HTTP bearer

Request body

account_role'OWNER' | 'ADMIN' | 'MEMBER' required

Who administers the account. Independent of access_level, which says how much access someone has to a given company.

OWNER — full control, including billing, API keys and transferring ownership. Exactly one per account, so it is never an accepted value when you SET a role (inviting a member or changing one's role): both reject it with 422 OWNER_ROLE_NOT_ASSIGNABLE. Ownership moves only through PUT /v1/accounts/{account_id}/owner. ADMIN — everything an OWNER can do, except transferring ownership. MEMBER — no account administration. Access to each company is granted individually and reported as access_level; a member only sees the companies granted to them.

Response

Member role updated successfully

successboolean required

Example response

{
  "success": true,
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.