> For the complete documentation index, see [llms.txt](https://docs.discloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discloud.com/api-and-integrations/api-overview/team-management-endpoints.md).

# Equipe

## Permissões de um role

> Retorna as permissões associadas a um role (admin, developer ou viewer).

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Gerenciamento de Equipe","description":"Operações sobre gerenciamento de equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/roles/{role}/permissions":{"get":{"tags":["Gerenciamento de Equipe"],"summary":"Permissões de um role","description":"Retorna as permissões associadas a um role (admin, developer ou viewer).","operationId":"teamRolePermissions","parameters":[{"name":"role","in":"path","required":true,"description":"Role (admin, developer ou viewer)","schema":{"type":"string"}}],"responses":{"200":{"description":"Permissões do role","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Role inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Detalhes do team

> Retorna os detalhes de um team, incluindo membros e projetos.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Gerenciamento de Equipe","description":"Operações sobre gerenciamento de equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}":{"get":{"tags":["Gerenciamento de Equipe"],"summary":"Detalhes do team","description":"Retorna os detalhes de um team, incluindo membros e projetos.","operationId":"getTeam","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}}],"responses":{"200":{"description":"Detalhes do team","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para ver o team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Deletar team

> Remove um team. Apenas o dono.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Gerenciamento de Equipe","description":"Operações sobre gerenciamento de equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}":{"delete":{"tags":["Gerenciamento de Equipe"],"summary":"Deletar team","description":"Remove um team. Apenas o dono.","operationId":"deleteTeam","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}}],"responses":{"200":{"description":"Team deletado com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Não é o dono do team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Atualizar team

> Atualiza nome e/ou descrição de um team. Apenas o dono.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Gerenciamento de Equipe","description":"Operações sobre gerenciamento de equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}":{"patch":{"tags":["Gerenciamento de Equipe"],"summary":"Atualizar team","description":"Atualiza nome e/ou descrição de um team. Apenas o dono.","operationId":"updateTeam","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}}}}}},"responses":{"200":{"description":"Team atualizado com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Não é o dono do team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Listar membros

> Lista os membros de um team.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Membro da Equipe","description":"Operações sobre membros da equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}/members":{"get":{"tags":["Membro da Equipe"],"summary":"Listar membros","description":"Lista os membros de um team.","operationId":"listTeamMembers","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}}],"responses":{"200":{"description":"Membros listados com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para ver os membros","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Adicionar membro

> Adiciona um membro ao team com um role específico.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Membro da Equipe","description":"Operações sobre membros da equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}/members":{"post":{"tags":["Membro da Equipe"],"summary":"Adicionar membro","description":"Adiciona um membro ao team com um role específico.","operationId":"addTeamMember","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["userID","role"],"properties":{"userID":{"type":"string"},"role":{"type":"string","description":"admin, developer ou viewer"}}}}}},"responses":{"201":{"description":"Membro adicionado com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para gerenciar membros","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team ou usuário não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Remover membro

> Remove um membro do team.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Membro da Equipe","description":"Operações sobre membros da equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}/members/{memberUserID}":{"delete":{"tags":["Membro da Equipe"],"summary":"Remover membro","description":"Remove um membro do team.","operationId":"removeTeamMember","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}},{"name":"memberUserID","in":"path","required":true,"description":"ID do usuário membro","schema":{"type":"string"}}],"responses":{"200":{"description":"Membro removido com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para gerenciar membros","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team ou membro não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Atualizar role do membro

> Atualiza o role de um membro do team.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Membro da Equipe","description":"Operações sobre membros da equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}/members/{memberUserID}":{"patch":{"tags":["Membro da Equipe"],"summary":"Atualizar role do membro","description":"Atualiza o role de um membro do team.","operationId":"updateTeamMember","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}},{"name":"memberUserID","in":"path","required":true,"description":"ID do usuário membro","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["role"],"properties":{"role":{"type":"string","description":"admin, developer ou viewer"}}}}}},"responses":{"200":{"description":"Role atualizado com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para gerenciar membros","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team ou membro não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Sair do team

> Remove o próprio usuário do team. O dono não pode sair.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Membro da Equipe","description":"Operações sobre membros da equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/{teamID}/leave":{"post":{"tags":["Membro da Equipe"],"summary":"Sair do team","description":"Remove o próprio usuário do team. O dono não pode sair.","operationId":"leaveTeam","parameters":[{"name":"teamID","in":"path","required":true,"description":"ID do team","schema":{"type":"string"}}],"responses":{"200":{"description":"Saiu do team com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"O dono não pode sair do team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Team não encontrado ou não é membro","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Criar team

> Cria um novo team. Requer plano compatível.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Gerenciamento de Equipe","description":"Operações sobre gerenciamento de equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams":{"post":{"tags":["Gerenciamento de Equipe"],"summary":"Criar team","description":"Cria um novo team. Requer plano compatível.","operationId":"createTeam","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Nome do team (máx. 50 caracteres)"},"description":{"type":"string"}}}}}},"responses":{"201":{"description":"Team criado com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Plano não permite criar teams ou limite atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Listar teams

> Lista os teams do usuário (próprios e onde é membro).

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Gerenciamento de Equipe","description":"Operações sobre gerenciamento de equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams":{"get":{"tags":["Gerenciamento de Equipe"],"summary":"Listar teams","description":"Lista os teams do usuário (próprios e onde é membro).","operationId":"listTeams","responses":{"200":{"description":"Teams listados com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Apps acessíveis via teams

> Lista os apps acessíveis pelo usuário através dos teams a que pertence.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Gerenciamento de Equipe","description":"Operações sobre gerenciamento de equipe"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/teams/apps":{"get":{"tags":["Gerenciamento de Equipe"],"summary":"Apps acessíveis via teams","description":"Lista os apps acessíveis pelo usuário através dos teams a que pertence.","operationId":"listTeamsApps","responses":{"200":{"description":"Apps acessíveis listados com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```