API reference
Write, move and delete files in a task's working folder.
Change a task's files between turns, so the next turn works on what you put there.
Endpoints
PUT /v1/sessions/{id}/files/{path} {"content": "..."} or {"content_b64": "..."}
POST /v1/sessions/{id}/files/{path}:mkdir create a folder
POST /v1/sessions/{id}/files/{path}:move {"to": "<new path>"}
DELETE /v1/sessions/{id}/files/{path} delete a file, or a folder and everything in itRules
- Size
- Up to 4 MiB per write; more answers 413 with
payload_too_large. For larger files, upload them and name them on the next task. - While a turn runs
- Every change answers 409 with
session_busy, so the agent never sees a file change under it. Write between turns. - Paths
- Relative to the task's folder.
- Sessions and filesReading a task's files and its archive.
- Upload filesLarger inputs for a task.
Ready to run this against a live workspace?Create API key