Organizações
Listar organizações
Seção intitulada “Listar organizações”GET /api/v1/organizationsRetorna todas as organizações às quais o usuário autenticado pertence.
Resposta
Seção intitulada “Resposta”{ "data": [ { "id": "org_uuid", "name": "Acme Inc.", "role": "ADMIN", "member_count": 12 } ]}Valores de função
Seção intitulada “Valores de função”| Função | Descrição |
|---|---|
OWNER | Acesso total, pode transferir ou excluir a organização |
ADMIN | Gerenciar membros, pastas e todas as gravações |
EDITOR | Criar e gerenciar as próprias gravações |
VIEWER | Acesso somente leitura |
Listar pastas
Seção intitulada “Listar pastas”GET /api/v1/organizations/:id/foldersRetorna todas as pastas ativas na organização. O usuário autenticado deve ser um membro.
Resposta
Seção intitulada “Resposta”{ "data": [ { "id": "folder_uuid", "name": "Product team" } ]}Listar membros
Seção intitulada “Listar membros”GET /api/v1/organizations/:id/membersRetorna todos os membros da organização. O usuário autenticado deve ser um membro.
Resposta
Seção intitulada “Resposta”{ "data": [ { "id": "user_uuid", "email": "alice@example.com", "name": "Alice", "role": "EDITOR" } ]}Códigos de erro
Seção intitulada “Códigos de erro”| Código | Status HTTP | Significado |
|---|---|---|
FORBIDDEN | 403 | O usuário não é membro desta organização |
ORGANIZATION_NOT_FOUND | 404 | A organização não existe |