Platform API

Update a team member

Change an eligible existing MindBill account's role or active state.

PATCHhttps://app.mindbill.org/partner/v2/organization/team/{id}

Apply a reviewed team-access change after authorizing the host user on your server.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: orgs:team:write · Browser: team:manage

IdempotencyNot required

Use this URL with a server API key or a browser session and its exact allowed Origin. Both credentials use the same request and response contract. See the component API inventory for exact paths and SDK methods.

Path parameters

FieldTypeDescription

idRequired

string

Identifier returned by this organization's list endpoint.

Request body

FieldTypeDescription

role

"admin" | "manager" | "biller" | "payments" | "viewer"

Assignable role. Existing legacy member or protected super_admin values may appear in reads; they are not assignment choices.

active

boolean

Whether this account is active.

Examples

curl 'https://app.mindbill.org/partner/v2/organization/team/user_example' \
  --request PATCH \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"role":"biller"}'

Response

200 OK

{
  "data": {
    "id": "user_example",
    "email": "biller@example.com",
    "name": "Example Biller",
    "role": "biller",
    "active": true,
    "createdAt": "2026-09-01T12:00:00.000Z",
    "canManage": true
  }
}

FieldTypeDescription

dataRequired

TeamMember

Updated account, including canManage.