Project tokens

Token

Token by ID.

GEThttps://cloud-api.calyptia.com/v1/project_tokens/{tokenID}

Authorization

userproject

Path parameters

tokenID*string (uuid)

Response

200

OK

Body

application/json

id*string (uuid)

token*string

Example: "redacted"

name*string

Example: "my-token"

permissions*array of Permission (enum)

createdAt*string (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://cloud-api.calyptia.com/v1/project_tokens/{tokenID}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "token": "redacted",
  "name": "my-token",
  "permissions": [
    "create:*"
  ],
  "createdAt": "2024-12-22T05:47:28.938Z"
}

Delete token

Delete token by its ID.

DELETEhttps://cloud-api.calyptia.com/v1/project_tokens/{tokenID}

Authorization

userproject

Path parameters

tokenID*string (uuid)

Response

204

No Content

Request

JavaScriptCurlPython

const response = await fetch('https://cloud-api.calyptia.com/v1/project_tokens/{tokenID}', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Update token

Update token by its ID.

PATCHhttps://cloud-api.calyptia.com/v1/project_tokens/{tokenID}

Authorization

userproject

Path parameters

tokenID*string (uuid)

Body

application/json

namenullable string

Example: "new-token"

permissionsnullable array of Permission (enum)

An empty list means it has all permissions.

Response

204

No Content

Request

JavaScriptCurlPython

const response = await fetch('https://cloud-api.calyptia.com/v1/project_tokens/{tokenID}', {
    method: 'PATCH',
    headers: {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();