Listar Organizacoes
Retorna todas as organizacoes das quais o usuario autenticado e membro.
Requisicao
GET /v1/organizations
URL completa: https://api.tapsign.com.br/v1/organizations
Headers
| Header | Valor |
|---|---|
Authorization | Bearer {token} |
Exemplo de requisicao
curl -X GET https://api.tapsign.com.br/v1/organizations \
-H "Authorization: Bearer {token}"
Resposta
Status: 200 OK
{
"content": [
{
"id": "org_abc123",
"name": "Empresa Exemplo LTDA",
"logoUrl": "https://cdn.tapsign.com.br/orgs/org_abc123/logo.png",
"role": "OWNER",
"memberCount": 12
},
{
"id": "org_def456",
"name": "Startup XYZ",
"logoUrl": null,
"role": "MEMBER",
"memberCount": 5
}
]
}
Campos da resposta
| Campo | Tipo | Descricao |
|---|---|---|
id | string | Identificador unico da organizacao |
name | string | Nome da organizacao |
logoUrl | string | null | URL do logotipo da organizacao |
role | string | Papel do usuario na organizacao: OWNER, ADMIN, MEMBER ou CUSTOM |
memberCount | integer | Numero total de membros na organizacao |
Organizacao padrao
Todo usuario possui pelo menos uma organizacao (criada automaticamente no cadastro). Essa organizacao e usada como padrao quando nenhum organizationId e informado nas requisicoes.
Erros comuns
| Status | Codigo | Descricao |
|---|---|---|
| 401 | UNAUTHORIZED | Token de autenticacao invalido ou ausente |