Skip to main content
DELETE
/
organizations
/
{organizationId}
/
roles
/
{slug}
Excluir Role
curl --request DELETE \
  --url https://api.example.com/organizations/{organizationId}/roles/{slug} \
  --header 'Authorization: <authorization>'
// No content - role deleted
Exclui um role pelo slug.
Excluir um role e permanente e nao pode ser desfeito. Membros atualmente com este role perderao as permissoes associadas. Reatribua os roles antes de excluir. Roles do ambiente nao podem ser excluidos.
curl -X DELETE https://api.awsales.io/studio/organizations/ORG_ID/roles/custom-editor \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Requer permissao roles:delete.

Cabecalhos

Authorization
string
required
Token bearer.

Parametros de Rota

organizationId
string
required
O UUID da organizacao.
slug
string
required
O slug do role.

Resposta

// No content - role deleted

Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401unauthorizedAutenticacao ausente ou invalida
403forbiddenPermissoes insuficientes
403role.cannot_delete_environment_roleNao e possivel excluir um role do ambiente
403role.cannot_modify_inheritedNao e possivel modificar um role herdado
404organization.not_foundOrganizacao nao encontrada
404role.not_foundRole nao encontrado
500internal_server_errorOcorreu um erro inesperado