Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agent37.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Every instance has a real filesystem. You upload a file into it, then reference the path in your message. The agent reads it off disk, can run code against it, and it stays for later turns. There is no attachment field: the message is plain text that names a path.

​
Endpoints

ActionEndpoint
UploadPOST /v1/instances/{id}/files (multipart)
List a directoryGET /v1/instances/{id}/files?path=
Read / downloadGET /v1/instances/{id}/files/content?path=
DeleteDELETE /v1/instances/{id}/files?path=

​
Upload a file

Send the file as multipart/form-data on the files field. The response returns the path it landed at and its size in bytes. 
curl -X POST https://api.agent37.com/v1/instances/inst_x7/files \
  -H "Authorization: Bearer sk_live_..." \
  -F "files=@report.pdf"
# -> { "path": "~/uploads/report.pdf", "bytes": 91833 }
​
path
string
The path the file landed at on the instance. Use this verbatim when you reference it in a message.
​
bytes
integer
The uploaded file’s size in bytes.

​
Upload, then ask

Reference the path from the upload in input. The message is plain text: naming the path is all it takes for the agent to open the file. 
# 1. upload
curl -X POST https://api.agent37.com/v1/instances/inst_x7/files \
  -H "Authorization: Bearer sk_live_..." \
  -F "files=@report.pdf"
# -> { "path": "~/uploads/report.pdf", "bytes": 91833 }

# 2. reference the path in your message
curl https://api.agent37.com/v1/responses \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "instance_id": "inst_x7",
    "input": "Summarize ~/uploads/report.pdf."
  }'
The file persists on the instance, so later messages in any session can reference the same path without re-uploading.

​
List, read, and delete

Pass path to list its entries.
curl
curl "https://api.agent37.com/v1/instances/inst_x7/files?path=~/uploads" \
  -H "Authorization: Bearer sk_live_..."
Pass the file’s path to get its contents back.
curl
curl "https://api.agent37.com/v1/instances/inst_x7/files/content?path=~/uploads/report.pdf" \
  -H "Authorization: Bearer sk_live_..." \
  -o report.pdf
Pass the file’s path. Deletion removes it from the instance’s disk.
curl
curl -X DELETE "https://api.agent37.com/v1/instances/inst_x7/files?path=~/uploads/report.pdf" \
  -H "Authorization: Bearer sk_live_..."
Deleting a file removes it from the instance’s disk. The agent can no longer read it on later turns.

​
Next steps

Send a message

Reference an uploaded path in input and read output_text back.

Instances

The computer that holds the filesystem, running until you delete it.