ActUpon Docs

Quickstart

Get a scoped token, list saved ActUpon items, then move to the agent inbox or workflow status APIs as needed.

1. Create a personal agent token

Today, personal agent tokens are created from the signed-in ActUpon web app. Open the app, navigate to the agent token section, and create a token with the scopes you need.

Current scopes are:

read_items for listing and reading items or inbox entries.
update_workflow_status for claim, release, done, and reopen actions.

2. List recent saved items

The items API returns saved ActUpon items with their structured payload, status, tags, and a signedimage_url for the original source asset.

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

3. Query the workflow inbox

Use the inbox API when you want pending workflow items instead of the full saved history. This is the better entrypoint for agents that operate on a queue.

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

4. Move to the next contract page

If you are building a local agent handoff, read the Agent Inbox page next. If you are integrating a queue or worker, read the Inbox API and Agent Tokens pages next.