DotsDocs
Team

Change an App Developer's Role

Give a team member a built-in role or a custom role. Send exactly one of `role` or `custom_role_id`; setting one clears the other. A change that would leave the App without an admin is rejected. Organization-level members (`scope: organization`) cannot be changed here; use `update-organization-developer` with an organization API key.

PATCH
/v2/developers/{developer_id}

Give a team member a built-in role or a custom role. Send exactly one of role or custom_role_id; setting one clears the other.

A change that would leave the App without an admin is rejected.

Organization-level members (scope: organization) cannot be changed here; use update-organization-developer with an organization API key.

Authorization

api_key
headerAuthorizationBasic <token>

Path Parameters

developer_id*string

The team member's id from get-developers.

Formatuuid

Request Body

application/json
  1. body
Properties1 <= properties <= 1
role?built-in-role

A built-in role. admin can do everything.

Value in"payer""viewer""admin""ap_approver""ap_creator""viewer_clawback""customer_service""compliance""user_manager"
custom_role_id?string

ID of a custom role in the same scope.

Formatuuid

Response Body

OK

application/json
  1. response

A team member: a developer account's membership in an App or organization.

id?string

ID of the membership. Use it to change the member's role, remove them, or assign them as an approver.

Formatuuid
first_name?string|null
last_name?string|null
email?string
Formatemail
role?|

custom when the member has a custom role, otherwise a built-in role.

role_display_name?|

Name of the custom role, or null for a built-in role.

custom_role_id?|
Formatuuid
scope?string

Whether access comes from the App or the organization.

Value in"app""organization"
curl -X PATCH 'https://api.dots.dev/api/v2/developers/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{  "role": "payer"}'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "first_name": "string",  "last_name": "string",  "email": "user@example.com",  "role": "payer",  "role_display_name": "string",  "custom_role_id": "4f5deddb-3218-41fa-acf0-ef42cdc17a8c",  "scope": "app"}