Agent files

Overview

Each personal CREAO agent has a durable file space — the skill folder mounted into sandbox runs (for example SKILL.md plus supporting scripts and templates). The Developer API can list those files, fetch a short-lived download URL, and delete a file. Upload is not available on the Developer API today; use the CREAO web UI or agent runs to add files.

List files

curl https://developer.creao.ai/v1/agents/00000000-0000-4000-8000-000000000000/files \
  -H "Authorization: Bearer cr_sk_your_key_here"

{
  "files": [
    {
      "id": "55555555-5555-4555-8555-555555555555",
      "name": "SKILL.md",
      "mime_type": "text/markdown",
      "size_bytes": 1204,
      "sha256": "abc123...",
      "created_at": "2026-07-02T00:00:00.000Z"
    }
  ]
}

Agents are capped at 50 files, so this endpoint is not paginated. Listings include the auto-staged SKILL.md when present.

Download a file

curl https://developer.creao.ai/v1/agents/00000000-0000-4000-8000-000000000000/files/55555555-5555-4555-8555-555555555555 \
  -H "Authorization: Bearer cr_sk_your_key_here"

{
  "id": "55555555-5555-4555-8555-555555555555",
  "name": "notes.txt",
  "mime_type": "text/plain",
  "size_bytes": 12,
  "sha256": null,
  "created_at": "2026-07-02T00:00:00.000Z",
  "download_url": "https://s3.example/notes.txt?X-Amz-Signature=...",
  "download_url_expires_at": "2026-07-02T01:00:00.000Z"
}

download_url is a presigned URL that expires in 1 hour.

Delete a file

curl -X DELETE https://developer.creao.ai/v1/agents/00000000-0000-4000-8000-000000000000/files/55555555-5555-4555-8555-555555555555 \
  -H "Authorization: Bearer cr_sk_your_key_here"

{
  "deleted": true
}

Deleting SKILL.md is allowed. CREAO re-stages it automatically the next time the agent’s skill content is updated.

Errors

Code	When
`AGENT_NOT_FOUND`	Agent is missing, not personal, or not owned by the API key account
`FILE_NOT_FOUND`	File ID is unknown or does not belong to this agent
`INVALID_INPUT`	Bad UUID path param

See also the OpenAPI operations under Agent Files.

Get Started

Agents

Agent Memory

Runs

Models

Concepts

Agent files

Overview

List files

Download a file

Delete a file

Errors

​Overview

​List files

​Download a file

​Delete a file

​Errors

Overview

List files

Download a file

Delete a file

Errors