Projeto
Lista os projetos acessíveis pelo usuário.
Projetos listados com sucesso
Erro de autenticação
GET /v2/projects HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Projetos listados com sucesso",
"data": [
{
"_id": "proj1719010867306",
"name": "Meu Projeto",
"teamID": null,
"clusterName": "fenrir"
}
]
}Cria um novo projeto. Requer plano compatível.
Nome do projeto (máx. 50 caracteres)
Team a vincular (opcional)
Projeto criado com sucesso
Dados inválidos
Erro de autenticação
Plano não permite criar projetos ou limite atingido
POST /v2/projects HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61
{
"name": "Meu Projeto",
"description": "Ambiente de produção"
}{
"status": "ok",
"message": "Projeto criado com sucesso",
"data": {
"_id": "proj1719010867306",
"ownerID": "470638301895294976",
"name": "Meu Projeto",
"description": "Ambiente de produção",
"teamID": null,
"clusterName": "fenrir"
}
}Retorna os detalhes de um projeto, incluindo team e apps.
ID do projeto
Projeto carregado com sucesso
Erro de autenticação
Sem permissão para ver o projeto
Projeto não encontrado
GET /v2/projects/{projectID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Projeto carregado com sucesso",
"data": {
"project": {
"_id": "proj1719010867306",
"name": "Meu Projeto",
"memberRole": "owner"
},
"team": null,
"apps": [
{
"_id": "1719010867306",
"nameTAG": "Meu Bot"
}
]
}
}Remove um projeto. Os apps vinculados são desvinculados (não deletados).
ID do projeto
Projeto deletado com sucesso
Erro de autenticação
Sem permissão para deletar o projeto
Projeto não encontrado
DELETE /v2/projects/{projectID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Projeto deletado com sucesso"
}Atualiza nome, descrição e/ou ícone de um projeto.
ID do projeto
Projeto atualizado com sucesso
Dados inválidos
Erro de autenticação
Sem permissão para gerenciar o projeto
Projeto não encontrado
PATCH /v2/projects/{projectID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 28
{
"name": "Projeto Renomeado"
}{
"status": "ok",
"message": "Projeto atualizado com sucesso",
"data": {
"_id": "proj1719010867306",
"name": "Projeto Renomeado"
}
}Vincula um team ao projeto (teamID) ou desvincula (teamID null). Apenas o dono do projeto.
ID do projeto
ID do team a vincular, ou null para desvincular
Team vinculado ou desvinculado com sucesso
teamID inválido
Erro de autenticação
Não é o dono do projeto ou plano insuficiente
Projeto ou team não encontrado
PATCH /v2/projects/{projectID}/team HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30
{
"teamID": "team1719010867306"
}{
"status": "ok",
"message": "Team vinculado ao projeto com sucesso",
"data": {
"_id": "proj1719010867306",
"teamID": "team1719010867306"
}
}Lista os apps que podem ser adicionados ao projeto.
ID do projeto
Apps disponíveis listados com sucesso
Erro de autenticação
Sem permissão para ver o projeto
Projeto não encontrado
GET /v2/projects/{projectID}/apps HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"data": [
{
"_id": "1719010867306",
"nameTAG": "Meu Bot",
"clusterName": "fenrir"
}
]
}Adiciona um app ao projeto. Se o cluster divergir, use migrate=true para migrar (resposta 202, migração assíncrona).
ID do projeto
ID da aplicação
Se true, migra o app para o cluster do projeto
App adicionado ao projeto com sucesso
Migração iniciada (processada de forma assíncrona)
Erro de autenticação
Sem permissão para gerenciar o projeto
Projeto ou app não encontrado
Cluster incompatível (migração necessária) ou migração já em andamento
PUT /v2/projects/{projectID}/apps/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 17
{
"migrate": false
}{
"status": "ok",
"message": "App adicionado ao projeto com sucesso",
"data": {
"_id": "1719010867306",
"projectID": "proj1719010867306",
"clusterName": "fenrir"
}
}Remove o app do projeto (define projectID null). O app não é deletado.
ID do projeto
ID da aplicação
App removido do projeto com sucesso
Erro de autenticação
Sem permissão para gerenciar o projeto
Projeto não encontrado ou app não pertence ao projeto
DELETE /v2/projects/{projectID}/apps/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "App removido do projeto com sucesso"
}Última atualização