---
title: "API de gerenciamento"
description: "Use chaves de API com escopo para gerenciar recursos da organização pelo seu backend."
locale: "pt-BR"
---

> Documentation Index
> Fetch the relevant documentation index at: https://vonvon.id/pt-br/llms.txt
> Use this file to discover all available pages before exploring further.

# API de gerenciamento

## 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.

```shell
curl https://vonvon.id/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.

Source: https://vonvon.id/pt-br/management-api/index.mdx