Update an App Custom Role
Rename a custom role or replace its actions. Only the fields you send change. Team members with the role get the new actions immediately.
Rename a custom role or replace its actions. Only the fields you send change. Team members with the role get the new actions immediately.
api_keyAuthorizationBasic <token>role_id*stringID of the custom role.
uuidapplication/json- body
1 <= propertiesname?stringName of the role. Must be unique among the scope's active custom roles.
1 <= length <= 100actions?array<>Permissions the role grants.
OK
application/json- response
id?stringuuidname?stringactions?array<>Permissions the role grants, sorted.
scope?stringWhether the role belongs to an App or to the organization.
"app""organization"curl -X PATCH 'https://api.dots.dev/api/v2/roles/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{ "actions": [ "get", "create_payout", "cancel_transfer", "view_payouts_tab" ]}'{ "id": "8a5f8a7e-1b0f-4f4b-9b2e-3c8d6f1e2a90", "name": "Payout operator", "actions": [ "create_payout", "get", "view_payouts_tab" ], "scope": "app"}Create an App Custom Role
Create a custom role on the App. Assign it to team members with `update-developer` or to new members with `create-developer-invite`.
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.