tasks

Write one task file [write]

Changed on

The body is the file's bytes (16 MiB at most; 413 file_too_large). The write becomes the current file. base_sha256 names what the caller last saw at the path (empty for nothing); when something else is current the default write is still made, both versions are kept, and the response says conflict: true. With require_base_match=true, a base is required and a mismatch instead returns 409 revision_conflict without updating the file. A task's space has no total-size or file-count limit. Sessions of the task pick the file up at the start of their next turn.

put/tasks/{id}/files/{path}

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/tasks/{id}/files/{path}
  • Auth
    HTTP bearer

Path parameters

idstring required

The task id: the id of its root session (sess_…)

pathstring required

The file's path inside the task's file space, such as report.md or data/rows.csv

Query parameters

base_sha256string
require_base_matchboolean

Request body application/octet-stream

string binary required

Response

OK

conflictboolean required

Changes

    • info

      added the new optional query request parameter require_base_match

    • info

      added the optional property / to the response with the status