Secrets

Core Instance Secrets

get

Secrets from a core instance with backward pagination.

Authorizations
Path parameters
coreInstanceIDstring · uuidRequired
Query parameters
lastintegerOptional

Limit to the last secrets.

beforestringOptional

Paginate secrets before the given cursor.

Responses
200
OK
application/json
get
GET /v1/core_instances/{coreInstanceID}/secrets HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "coreInstanceID": "123e4567-e89b-12d3-a456-426614174000",
      "key": "mysecret",
      "value": "Ynl0ZXM=",
      "createdAt": "2025-06-28T00:57:48.738Z",
      "updatedAt": "2025-06-28T00:57:48.738Z"
    }
  ],
  "endCursor": "text",
  "count": 1
}

Create Core Instance Secret

post

Create a new secret within a core instance. The secret will be created with the given name and content. If encypted is set to true, the secret will be encrypted using the core instance's encryption key. The name must be unique among all secrets within the core instance.

Authorizations
Path parameters
coreInstanceIDstring · uuidRequired
Body
keystringRequiredExample: mysecret
valuestring · byteRequired

The value of the secret in base 64 format.

Responses
201
Created
application/json
post
POST /v1/core_instances/{coreInstanceID}/secrets HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "key": "mysecret",
  "value": "Ynl0ZXM="
}
201

Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-06-28T00:57:48.738Z"
}