Ir para o conteúdo

API de gerenciamento

Use chaves de API com escopo para gerenciar recursos da organização pelo seu backend.

Ver como Markdown

Autenticação

As chamadas à Management API usam Authorization: Bearer sk_live_* ou Authorization: Bearer sk_test_*. As chaves são limitadas ao Tenant resolvido. Os recursos de Organization também verificam se a Organization solicitada pertence a esse Tenant.

curl https://xid.dev/v1/users \
  -H 'Authorization: Bearer sk_live_xxx'

Recursos

Recurso Recursos Estado
/v1/users Crie, leia, atualize, bana, remova banimento, exporte e remova usuários. Implementado
/v1/organizations Gerencie organizações, domínios, identidade visual e configurações. Implementado
/v1/organizations/:orgId/memberships Liste, crie, atualize o papel e remova membros. Implementado
/v1/organizations/:orgId/invitations Crie (com limite em massa), revogue e liste convites. Implementado
/v1/sessions Liste, obtenha e revogue sessões de usuário. Implementado
/v1/applications Registre clientes OAuth, URIs de redirecionamento, concessões, política de token e segredos. Implementado
/v1/connections Gerenciar conexoes SSO empresariais upstream. Implementado
/v1/directories Crie diretórios SCIM e rotacione tokens de diretório. Implementado
/v1/roles Crie, leia, atualize e exclua papéis personalizados. Implementado
/v1/permissions Crie, leia, atualize e exclua permissões. Implementado
/v1/project-grants Criar, listar, consultar, revogar e excluir permissões de projeto. Implementado
/v1/user-grants Atribua, liste, obtenha, revogue e exclua concessões de usuário com escopo definido. Implementado
/v1/organizations/:orgId/domains Liste, crie e remova domínios da organização. Implementado
/v1/organizations/:orgId/custom-hostnames Crie, inspecione, atualize e remova nomes de host personalizados. Implementado
/v1/organizations/:orgId/audit-events Consulte os eventos de auditoria da organização com paginação por cursor. Implementado
/v1/webhooks Crie, liste, atualize e exclua endpoints de webhook. Implementado
/v1/api-keys Crie, liste e revogue chaves de API da organização. Implementado
/v1/organizations/:orgId/scim-targets Crie, atualize, sincronize e remova destinos SCIM de saída. Implementado

Paginação e erros

Endpoints de lista retornam um array de dados e metadados de cursor. Erros usam JSON estruturado com código estável, mensagem legível por humanos e metadados opcionais para validação de campos.

Navegação

Digite para pesquisar...

Use as teclas de seta para navegarPressione Enter para selecionarPressione Escape para fechar