AgentConnect
Agent workspace

Create or replace a scratch workspace file

Atomically create or replace one UTF-8 file in a scratch workspace on the owning daemon. Requires edit access to the agent. Creation never overwrites an existing file; replacement requires the mtime returned by the last read. Conflicts return 409. GitHub workspaces remain read-only. The control plane stores no file content.

PUT
/v1/orgs/{orgId}/agents/{id}/workspace/file

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
id*string

Query Parameters

path*string
Length1 <= length <= 4096

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/orgs/string/agents/string/workspace/file?path=string" \  -H "Content-Type: application/json" \  -d '{    "content": "string"  }'
{  "path": "string",  "size": 0,  "mtime": "string"}