Scratchpad

List scratchpad items

Lists every live (non-expired) item in the org's shared scratchpad: a mid-week capture buffer that decays 30 days after creation and feeds Bob's weekly plan.

GET/api/public/scratchpad

cURLGET /api/public/scratchpad

curl "https://postiv.ai/api/public/scratchpad" \
  -H "Authorization: Bearer pk_postiv_..."

200Response

{
  "success": true,
  "items": [
    {
      "id": "sp1...",
      "kind": "note",
      "content": "Competitor just launched a carousel maker",
      "status": "fresh",
      "createdAt": "2026-07-18T10:00:00.000Z"
    }
  ]
}

Authorization

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

Response

Live scratchpad items.

items[]array

Each item serialized via serializeScratchpadItemRow: id, kind (note/url/image/file), content, status (fresh/suggested/used), url/imageUrl/fileUrl where applicable, boardPosition, createdBy, createdAt, expiresAt.

Good to know

Every scrap auto-expires 30 days after creation with no action needed.