Project

List projects

get

Lists the projects accessible by the user.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

Projects listed successfully

application/json

objectOptional

401

Authentication error

application/json

get/projects

HTTPcURLJavaScriptPython

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

{
  "status": "ok",
  "message": "Projects listed successfully",
  "data": [
    {
      "_id": "proj1719010867306",
      "name": "My Project",
      "teamID": null,
      "clusterName": "fenrir"
    }
  ]
}

Create project

post

Creates a new project. Requires a compatible plan.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Body

application/json

namestringRequired

Project name (max. 50 characters)

descriptionstringOptional

iconstringOptional

teamIDstringOptional

Team to link (optional)

fromAppIDsstring[]Optional

Responses

201

Project created successfully

application/json

objectOptional

400

Invalid data

application/json

401

Authentication error

application/json

403

Plan does not allow creating projects or limit reached

application/json

post/projects

HTTPcURLJavaScriptPython

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

{
  "name": "My Project",
  "description": "Production environment"
}

{
  "status": "ok",
  "message": "Project created successfully",
  "data": {
    "_id": "proj1719010867306",
    "ownerID": "470638301895294976",
    "name": "My Project",
    "description": "Production environment",
    "teamID": null,
    "clusterName": "fenrir"
  }
}

Project details

get

Returns the details of a project, including team and apps.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

Responses

200

Project loaded successfully

application/json

objectOptional

401

Authentication error

application/json

403

No permission to view the project

application/json

404

Project not found

application/json

get/projects/{projectID}

HTTPcURLJavaScriptPython

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

{
  "status": "ok",
  "message": "Project loaded successfully",
  "data": {
    "project": {
      "_id": "proj1719010867306",
      "name": "My Project",
      "memberRole": "owner"
    },
    "team": null,
    "apps": [
      {
        "_id": "1719010867306",
        "nameTAG": "My Bot"
      }
    ]
  }
}

Update project

patch

Updates the name, description and/or icon of a project.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

Body

application/json

namestringOptional

descriptionstringOptional

iconstringOptional

Responses

200

Project updated successfully

application/json

objectOptional

400

Invalid data

application/json

401

Authentication error

application/json

403

No permission to manage the project

application/json

404

Project not found

application/json

patch/projects/{projectID}

HTTPcURLJavaScriptPython

PATCH /v2/projects/{projectID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "name": "Renamed Project"
}

{
  "status": "ok",
  "message": "Project updated successfully",
  "data": {
    "_id": "proj1719010867306",
    "name": "Renamed Project"
  }
}

Link/unlink team

patch

Links a team to the project (teamID) or unlinks it (teamID null). Owner only.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

Body

application/json

teamIDstring · nullableOptional

Team ID to link, or null to unlink

Responses

200

Team linked or unlinked successfully

application/json

objectOptional

400

Invalid teamID

application/json

401

Authentication error

application/json

403

Not the project owner or insufficient plan

application/json

404

Project or team not found

application/json

patch/projects/{projectID}/team

HTTPcURLJavaScriptPython

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 linked to the project successfully",
  "data": {
    "_id": "proj1719010867306",
    "teamID": "team1719010867306"
  }
}

List available apps

get

Lists the apps that can be added to the project.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

Responses

200

Available apps listed successfully

application/json

objectOptional

401

Authentication error

application/json

403

No permission to view the project

application/json

404

Project not found

application/json

get/projects/{projectID}/apps

HTTPcURLJavaScriptPython

GET /v2/projects/{projectID}/apps HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "data": [
    {
      "_id": "1719010867306",
      "nameTAG": "My Bot",
      "clusterName": "fenrir"
    }
  ]
}

Add/move app to project

put

Adds an app to the project. If the cluster differs, use migrate=true to migrate (202 response, asynchronous migration).

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

appIDstringRequired

Application ID

Body

application/json

migratebooleanOptional

If true, migrates the app to the project's cluster

Responses

200

App added to the project successfully

application/json

objectOptional

202

Migration started (processed asynchronously)

application/json

401

Authentication error

application/json

403

No permission to manage the project

application/json

404

Project or app not found

application/json

409

Cluster mismatch (migration required) or migration already in progress

application/json

put/projects/{projectID}/apps/{appID}

HTTPcURLJavaScriptPython

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 added to the project successfully",
  "data": {
    "_id": "1719010867306",
    "projectID": "proj1719010867306",
    "clusterName": "fenrir"
  }
}

Remove app from project

delete

Removes the app from the project (sets projectID null). The app is not deleted.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

appIDstringRequired

Application ID

Responses

200

App removed from the project successfully

application/json

objectOptional

401

Authentication error

application/json

403

No permission to manage the project

application/json

404

Project not found or app does not belong to the project

application/json

delete/projects/{projectID}/apps/{appID}

HTTPcURLJavaScriptPython

DELETE /v2/projects/{projectID}/apps/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "App removed from the project successfully"
}