Files

The workspace persists across sessions. You can stage inputs, retrieve outputs, and version files via standard HTTP.

PUT /v1/sessions/{id}/files/{path}

Upload a file. Body is the raw bytes; Content-Type is your choice.

curl -X PUT "$POKEE_API/v1/sessions/$SID/files/inputs/research_notes.md" \
  -H "Authorization: Bearer $POKEE_KEY" \
  -H "Content-Type: text/markdown" \
  --data-binary @research_notes.md

Response (201): {"path": "...", "size": 1234, "modified": 1777222996.07}.

Upload directories by repeating the call per file. Path traversal (..) is rejected.

GET /v1/sessions/{id}/files/{path}

Download a file. Streams the bytes back.

curl "$POKEE_API/v1/sessions/$SID/files/output/report.pdf" \
  -H "Authorization: Bearer $POKEE_KEY" -o report.pdf

Supports HTTP Range: headers for partial reads (resumable downloads). If path resolves to a directory, returns the JSON listing (same as /files?path=...).

GET /v1/sessions/{id}/files

List files. Optional query: ?path=subdir.

curl "$POKEE_API/v1/sessions/$SID/files?path=output" \
  -H "Authorization: Bearer $POKEE_KEY"

Returns [{"name":"...", "type":"file"|"directory", "size":1234, "modified":...}].

DELETE /v1/sessions/{id}/files/{path}

Delete a file. Returns 204 or 404.