Skip to main content
PATCH
/
api
/
agents
/
{agent_uid}
/
scratchpads
/
{scratchpad_uid}
Update scratchpad
curl --request PATCH \
  --url https://api.example.com/api/agents/{agent_uid}/scratchpads/{scratchpad_uid} \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>"
}
'
Updates the markdown content of a scratchpad associated with an agent run. Scratchpads capture working notes and reasoning produced during agent execution and can be edited by users.

​
Path parameters

​
agent_uid
string
required
UUID of the agent that owns the scratchpad.
​
scratchpad_uid
string
required
UUID of the scratchpad to update.

​
Request body

​
content
string
required
Updated markdown content for the scratchpad.

​
Example request

{
  "content": "## Investigation Notes\n\nInvoice INV-2026-0042 is 15 days overdue. Customer has been contacted twice. Escalating to account manager."
}

​
Response

{
  "status": "success",
  "status_code": 200,
  "message": "Scratchpad updated",
  "data": {
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "agent_uid": "550e8400-e29b-41d4-a716-446655440000",
    "organization_uid": "660e8400-e29b-41d4-a716-446655440000",
    "content": "## Investigation Notes\n\nInvoice INV-2026-0042 is 15 days overdue. Customer has been contacted twice. Escalating to account manager.",
    "status": "open",
    "created_on": "2026-03-18T09:15:00Z",
    "updated_on": "2026-03-20T10:00:00Z",
    "closed_on": null
  }
}

​
Errors

StatusReason
403User is not authorized to edit the scratchpad
404Agent or scratchpad not found
422Missing content field or invalid type