ActUpon Docs

API: Items

List saved ActUpon items, fetch a single item, and update workflow status or claim state when your token has the right scope.

GET /api/screenshotaction/items

Lists recent saved items for the authenticated user.

Tags are separate structured metadata on each item. Use tag filters for routing and retrieval, and keepaction_note as human-readable context.

Query parameters:

format: json or md.
type: event, media, or reference.
status: item extraction status.
tag: exact tag match.
tags: comma-separated structured tags. All listed tags must be present.
cursor: pagination cursor based on created_at.
limit: 1 to 200, default 50.

curl -X GET \
  "https://actupon.app/api/screenshotaction/items?format=json&limit=20&type=reference&tags=codex,thecrux" \
  -H "Authorization: Bearer actpt_your_token_here"

GET /api/screenshotaction/items/{id}

Returns one item with a signed source image URL.

curl -X GET \
  "https://actupon.app/api/screenshotaction/items/itm_123?format=json" \
  -H "Authorization: Bearer actpt_your_token_here"

PATCH /api/screenshotaction/items/{id}

Use this endpoint to claim, release, mark done, reopen, or attach a resolution note. Bearer tokens needupdate_workflow_status for status updates and claim actions. Signed-in browser sessions can also send corrections.tags and corrections.action_note to keep notes freeform while storing routing tags separately as the canonical retrieval field.

curl -X PATCH \
  "https://actupon.app/api/screenshotaction/items/itm_123" \
  -H "Authorization: Bearer actpt_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "corrections": {
      "action_note": "Review with the platform team",
      "tags": ["linear", "bug", "android"]
    }
  }'