Access control

Assign role

Set a member's role in the current organization.

PUT/organizations/members/{user_id}/role

Set a member’s role in the current organization. role is the identifier, such as admin or finance-ops, not role_id.

There is no unassign, so assign a different role to take one away. Invites from the dashboard only offer built-in roles, so assign a custom role with this endpoint after the person joins. The call fails if it would remove the last admin.

Send Authorization: Bearer with a token for the current organization. On Blnk Cloud the host is https://api.cloud.blnkfinance.com.

Authorizationstringrequiredheader

Bearer token for the current organization.

Path

user_idstringrequiredpath

Id of the member from List team members.

Body

rolestringrequiredbody

Identifier of the role, such as admin or finance-ops. Do not send role_id.

Response

A 200 response returns a confirmation message.

messagestringrequired

Member role updated successfully.

curl -X PUT "https://api.cloud.blnkfinance.com/organizations/members/user_01K4EX0BRXHNNGCRVT2TPNK07W/role" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"role":"finance-ops"}'

{
  "message": "Member role updated successfully"
}