Equipe

Team

Permissões de um role

get

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

rolestringRequired

Role (admin, developer ou viewer)

Responses

200

Permissões do role

application/json

objectOptional

400

Role inválido

application/json

401

Erro de autenticação

application/json

get/teams/roles/{role}/permissions

HTTPcURLJavaScriptPython

GET /v2/teams/roles/{role}/permissions HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Permissões do role admin",
  "data": {
    "role": "admin",
    "permissions": [
      "config_app",
      "start_stop",
      "view_logs"
    ]
  }
}

Detalhes do team

get

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

Responses

200

Detalhes do team

application/json

objectOptional

401

Erro de autenticação

application/json

403

Sem permissão para ver o team

application/json

404

Team não encontrado

application/json

get/teams/{teamID}

HTTPcURLJavaScriptPython

GET /v2/teams/{teamID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Detalhes do team",
  "data": {
    "team": {
      "_id": "team1719010867306",
      "name": "Meu Team"
    },
    "members": [
      {
        "userID": "470638301895294976",
        "role": "owner"
      }
    ],
    "projects": [
      {
        "_id": "proj1719010867306",
        "name": "Meu Projeto"
      }
    ]
  }
}

Deletar team

delete

Remove um team. Apenas o dono.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

Responses

200

Team deletado com sucesso

application/json

objectOptional

401

Erro de autenticação

application/json

403

Não é o dono do team

application/json

404

Team não encontrado

application/json

delete/teams/{teamID}

HTTPcURLJavaScriptPython

DELETE /v2/teams/{teamID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Team deletado com sucesso"
}

Atualizar team

patch

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

Body

application/json

namestringOptional

descriptionstringOptional

Responses

200

Team atualizado com sucesso

application/json

objectOptional

400

Dados inválidos

application/json

401

Erro de autenticação

application/json

403

Não é o dono do team

application/json

404

Team não encontrado

application/json

patch/teams/{teamID}

HTTPcURLJavaScriptPython

PATCH /v2/teams/{teamID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "name": "Team Renomeado"
}

{
  "status": "ok",
  "message": "Team atualizado com sucesso",
  "data": {
    "_id": "team1719010867306",
    "name": "Team Renomeado"
  }
}

Listar membros

get

Lista os membros de um team.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

Responses

200

Membros listados com sucesso

application/json

objectOptional

401

Erro de autenticação

application/json

403

Sem permissão para ver os membros

application/json

404

Team não encontrado

application/json

get/teams/{teamID}/members

HTTPcURLJavaScriptPython

GET /v2/teams/{teamID}/members HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Membros listados com sucesso",
  "data": [
    {
      "userID": "470638301895294976",
      "role": "owner",
      "username": "dono"
    }
  ]
}

Adicionar membro

post

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

Body

application/json

userIDstringRequired

rolestringRequired

admin, developer ou viewer

Responses

201

Membro adicionado com sucesso

application/json

objectOptional

400

Dados inválidos

application/json

401

Erro de autenticação

application/json

403

Sem permissão para gerenciar membros

application/json

404

Team ou usuário não encontrado

application/json

post/teams/{teamID}/members

HTTPcURLJavaScriptPython

POST /v2/teams/{teamID}/members HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "userID": "123456789012345678",
  "role": "developer"
}

{
  "status": "ok",
  "message": "Membro adicionado com sucesso",
  "data": {
    "userID": "123456789012345678",
    "role": "developer",
    "username": "fulano"
  }
}

Remover membro

delete

Remove um membro do team.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

memberUserIDstringRequired

ID do usuário membro

Responses

200

Membro removido com sucesso

application/json

objectOptional

401

Erro de autenticação

application/json

403

Sem permissão para gerenciar membros

application/json

404

Team ou membro não encontrado

application/json

delete/teams/{teamID}/members/{memberUserID}

HTTPcURLJavaScriptPython

DELETE /v2/teams/{teamID}/members/{memberUserID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Membro removido com sucesso"
}

Atualizar role do membro

patch

Atualiza o role de um membro do team.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

memberUserIDstringRequired

ID do usuário membro

Body

application/json

rolestringRequired

admin, developer ou viewer

Responses

200

Role atualizado com sucesso

application/json

objectOptional

400

Dados inválidos

application/json

401

Erro de autenticação

application/json

403

Sem permissão para gerenciar membros

application/json

404

Team ou membro não encontrado

application/json

patch/teams/{teamID}/members/{memberUserID}

HTTPcURLJavaScriptPython

PATCH /v2/teams/{teamID}/members/{memberUserID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "role": "admin"
}

{
  "status": "ok",
  "message": "Role atualizado com sucesso",
  "data": {
    "userID": "123456789012345678",
    "role": "admin"
  }
}

Sair do team

post

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

teamIDstringRequired

ID do team

Responses

200

Saiu do team com sucesso

application/json

objectOptional

401

Erro de autenticação

application/json

403

O dono não pode sair do team

application/json

404

Team não encontrado ou não é membro

application/json

post/teams/{teamID}/leave

HTTPcURLJavaScriptPython

POST /v2/teams/{teamID}/leave HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Você saiu do team com sucesso"
}

Criar team

post

Cria um novo team. Requer plano compatível.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Body

application/json

namestringRequired

Nome do team (máx. 50 caracteres)

descriptionstringOptional

Responses

201

Team criado com sucesso

application/json

objectOptional

400

Dados inválidos

application/json

401

Erro de autenticação

application/json

403

Plano não permite criar teams ou limite atingido

application/json

post/teams

HTTPcURLJavaScriptPython

POST /v2/teams HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "name": "Meu Team",
  "description": "Equipe de desenvolvimento"
}

{
  "status": "ok",
  "message": "Team criado com sucesso",
  "data": {
    "_id": "team1719010867306",
    "ownerID": "470638301895294976",
    "name": "Meu Team"
  }
}

Listar teams

get

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

Teams listados com sucesso

application/json

objectOptional

401

Erro de autenticação

application/json

get/teams

HTTPcURLJavaScriptPython

GET /v2/teams HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Teams listados com sucesso",
  "data": [
    {
      "_id": "team1719010867306",
      "name": "Meu Team",
      "isOwner": true
    }
  ]
}

Apps acessíveis via teams

get

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

Apps acessíveis listados com sucesso

application/json

objectOptional

401

Erro de autenticação

application/json

get/teams/apps

HTTPcURLJavaScriptPython

GET /v2/teams/apps HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Apps acessíveis via teams",
  "data": [
    {
      "_id": "1719010867306",
      "nameTAG": "Meu Bot",
      "teamID": "team1719010867306"
    }
  ]
}