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.

Query parameters:

format: json or md.
type: event, media, or reference.
status: item extraction status.
tag: exact tag match.
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&tag=codex" \
  -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.

curl -X PATCH \
  "https://actupon.app/api/screenshotaction/items/itm_123" \
  -H "Authorization: Bearer actpt_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_status": "done",
    "resolution_note": "Handled in Linear"
  }'