Files

Core Instance Files

get

Files from a core instance with backward pagination.

Authorizations

userproject

Path parameters

coreInstanceIDstring · uuidRequired

Query parameters

lastintegerOptional

Limit to the last files.

beforestringOptional

Paginate files before the given cursor.

Responses

200

OK

application/json

get

HTTPcURLJavaScriptPython

GET /v1/core_instances/{coreInstanceID}/files 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",
      "name": "myfile",
      "contents": "Ynl0ZXM=",
      "encrypted": false,
      "createdAt": "2025-06-28T00:38:29.425Z",
      "updatedAt": "2025-06-28T00:38:29.425Z"
    }
  ],
  "endCursor": "text",
  "count": 1
}

Create Core Instance File

post

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

Authorizations

userproject

Path parameters

coreInstanceIDstring · uuidRequired

Body

namestringRequiredExample: myfile

contentsstring · byteRequired

The contents of the file to be created in base 64 format.

encryptedbooleanRequiredDefault: false

Responses

201

Created

application/json

post

HTTPcURLJavaScriptPython

POST /v1/core_instances/{coreInstanceID}/files HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "name": "myfile",
  "contents": "Ynl0ZXM=",
  "encrypted": false
}

201

Created

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