Scratchpad

Update scratchpad item

Edits a scratchpad item's content, lifecycle status, and/or board position.

PATCH/api/public/scratchpad/:id

cURLPATCH /api/public/scratchpad/:id

curl -X PATCH https://postiv.ai/api/public/scratchpad/ID_ID \
  -H "Authorization: Bearer pk_postiv_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Three things we learned from launch week...",
    "status": "fresh"
  }'

200Response

{
  "success": true,
  "item": {
    "id": "sp1...",
    "status": "used"
  }
}

Authorization

Requires an organization API key with the scratchpad:write scope, sent as Authorization: Bearer or x-api-key.

Path parameters

idstringrequired

Resource id from the corresponding list or create endpoint.

Body parameters

contentstring

Max 50000 chars.

statusstring

One of:freshsuggestedused

boardPositionobject

{ x, y }.

Response

The updated item.

itemobject

Errors

400	validation_error: none of content/status/boardPosition provided
404	scratchpad_item_not_found

Good to know

boardPosition is REST-only (not exposed on the MCP update_scratchpad_item tool, which only takes content/status).