Pular para o conteúdo principal
POST
Criar papel
Exige roles:manage. Uma chave de API precisa do escopo workspaces:write.
Guarda contra escalonamento de privilégio: quem não é dono só pode conceder um conjunto de permissões que ele mesmo já tem. Não há verificação separada para “criar” e “editar” — sem isso, roles:manage sozinho permitiria que um membro criasse um papel com todas as permissões, inclusive as que ele não tem.
O número de papéis que um workspace pode ter é limitado pelo nível do plano do dono — os 4 papéis iniciais contam nesse limite.

Caminho

string
obrigatório
ID do workspace.

Corpo

string
obrigatório
De 1 a 50 caracteres.
WorkspacePermission[]
obrigatório
Subconjunto do catálogo de 20 entradas. Deve ser um subconjunto das permissões do próprio chamador, a menos que o chamador seja o dono.
number
De 0 a 999, ordem de exibição.

Resposta

Mesmo formato de uma linha de Listar papéis.

Erros

Última modificação em 28 de outubro de 2026