The world’s first unified interface for agent harnessesOpen Source4.4kPowered by UHP

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

Write to a task's folder
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 it

Rules

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.

Ready to run this against a live workspace?Create API key