File Management

Upload and manage elemental files and images

Upload images, documents, and other files to enhance your elementals.

Get Elemental File

get

Retrieves a specific file attached to an elemental.

Authorizations

ApiKeyAuth

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

elemental_idstringRequired

Elemental ID

file_idintegerRequired

File ID

Responses

200

File data

application/json

codeintegerOptional

HTTP status code

Example: 200

400

Invalid file ID parameter

401

Unauthorized

403

Access forbidden

404

File not found

application/json

get/v1/elemental/{elemental_id}/file/{file_id}

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/elemental/abc123/file/1" \
  -H "x-api-key: YOUR_API_KEY"

{
  "code": 200,
  "meta": {
    "version": "v1.0.2",
    "is_authenticaded": true,
    "limit": 1,
    "offset": 1,
    "total": 1
  },
  "response": {
    "id": 1,
    "name": "text",
    "size": 1,
    "created_at": "2026-07-14T02:26:45.634Z",
    "url": "text",
    "data": [
      1
    ]
  }
}

Upload Files to Elemental

post

Uploads files to an elemental.

File Limits

Type	Max Count	Description
images	4	Regular images
cover_images	4	Featured/cover images
avatar	1	Main avatar/icon
files	3 per request, 15 total	Document attachments

Authorizations

ApiKeyAuth

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

elemental_idstringRequired

Body

application/json

Responses

201

Files uploaded successfully

No content

403

Forbidden:

• You can send a maximum of 3 files at a time
• You can only add 15 files total
• You can only have 4 images and 4 cover images

post/v1/user/elemental/{elemental_id}/files

cURL

curl -X POST "https://api-integrations.snackprompt.com/v1/user/elemental/abc123/files" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [{
      "file_name": "screenshot.png",
      "file_buffer": {"type": "Buffer", "data": []}
    }]
  }'

No content

Delete Files from Elemental

delete

Deletes specific files from an elemental by their IDs.

Authorizations

ApiKeyAuth

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

elemental_idstringRequired

Body

application/json

imagesinteger[]Optional

cover_imagesinteger[]Optional

avatarbooleanOptional

filesinteger[]Optional

Responses

204

Files deleted successfully

No content

delete/v1/user/elemental/{elemental_id}/files

cURL

curl -X DELETE "https://api-integrations.snackprompt.com/v1/user/elemental/abc123/files" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"images": [1, 2]}'

204

Files deleted successfully

No content