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.
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.
api_keyAuthorizationBasic <token>developer_id*stringThe team member's id from get-developers.
uuidapplication/json- body
1 <= properties <= 1role?built-in-roleA built-in role. admin can do everything.
"payer""viewer""admin""ap_approver""ap_creator""viewer_clawback""customer_service""compliance""user_manager"custom_role_id?stringID of a custom role in the same scope.
uuidOK
application/json- response
A team member: a developer account's membership in an App or organization.
id?stringID of the membership. Use it to change the member's role, remove them, or assign them as an approver.
uuidfirst_name?string|nulllast_name?string|nullemail?stringemailrole?|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?|uuidscope?stringWhether access comes from the App or the organization.
"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"}'{ "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"}Delete an App Custom Role
Delete a custom role. A role that is assigned to a team member or to a pending invite cannot be deleted; move them to another role first. The name can be reused after deletion.
Remove an App Developer
Remove a team member from the App. Removing the last admin is rejected. Organization-level members cannot be removed here.