agents

Capture a reusable snapshot of the agent's devbox disk.

This ends the run: per-run state is stripped from the disk, the capture starts asynchronously, and the devbox shuts down once it completes. Poll the snapshot's status route until the capture finishes.

post/agents/{id}/snapshots

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/agents/{id}/snapshots
  • Auth: none declared. Required headers: x-organization-id

Path parameters

idstring required

Headers

x-organization-idstring required

Active organization id (or slug). Required for org-scoped operations; the generated client enforces it at compile time.

Request body

namestring required
commitMessagestring

Response

Response

idstring required
namestring required
createTimeMsnumber required
sourceDevboxIdstring required
sourceAgentIdstring
sourceAgentNamestring
commitMessagestring
sizeBytesnumber
metadataobject

Changes

No recorded changes to this operation across all 50 revisions of this API.