ActUpon Docs

API: Inbox

Query the pending workflow inbox for agent-style processing, filtering by action type, destination, and claim status.

GET /api/screenshotaction/inbox

The inbox endpoint is the queue-oriented view of ActUpon items. It returns completed extractions that still have a workflow status of pending or done.

Supported query parameters:

format: json or md.
workflow_status: pending or done.
requested_action: calendar, reminder, save, or workflow.
type: event, media, or reference.
destination_kind and destination_name for workflow-target filtering.
claim_status: all, available, claimed, or mine.
limit: 1 to 200, default 20.

curl -X GET \
  "https://actupon.app/api/screenshotaction/inbox?format=json&workflow_status=pending&requested_action=workflow&claim_status=available" \
  -H "Authorization: Bearer actpt_your_token_here"

When to use inbox instead of items

Use /items for general saved history and direct item lookup.
Use /inbox when your agent or worker is processing a queue of pending workflow tasks.