Secrets

Core Instance Secrets

Secrets from a core instance with backward pagination.

get

/v1/core_instances/{coreInstanceID}/secrets

Authorizations

userproject

Path parameters

coreInstanceIDstring · uuidrequired

Query parameters

lastinteger

Limit to the last secrets.

beforestring

Paginate secrets before the given cursor.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud-api.calyptia.com/v1/core_instances/{coreInstanceID}/secrets' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "coreInstanceID": "123e4567-e89b-12d3-a456-426614174000",
      "key": "mysecret",
      "value": "text",
      "createdAt": "2025-03-12T04:25:03.214Z",
      "updatedAt": "2025-03-12T04:25:03.214Z"
    }
  ],
  "endCursor": "text",
  "count": 1
}

OK

Create Core Instance Secret

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.

post

/v1/core_instances/{coreInstanceID}/secrets

Authorizations

userproject

Path parameters

coreInstanceIDstring · uuidrequired

Body

keystringrequired

Example: mysecret

valuestring · byterequired

The value of the secret in base 64 format.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://cloud-api.calyptia.com/v1/core_instances/{coreInstanceID}/secrets' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "key": "mysecret",
    "value": "text"
  }'

201

201

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-03-12T04:25:03.214Z"
}

Created