# ActUpon full agent guide

ActUpon turns screenshots, voice notes, and similar captures into structured items with explicit next actions.

Authentication:
- Public item and inbox APIs accept standard bearer auth.
- If the bearer token is not a signed-in session JWT, ActUpon checks whether it is a valid personal agent token.
- Current scopes are read_items and update_workflow_status.

Stable public docs:
- Overview: https://actupon.app/docs - What ActUpon exposes publicly for users, agents, and integrations.
- Quickstart: https://actupon.app/docs/quickstart - Token model, first API calls, and the shortest path to a working integration.
- Agent Inbox: https://actupon.app/docs/agent-inbox - How to route captures to Codex, Cursor, or other local agent workflows.
- API: Items: https://actupon.app/docs/api/items - List and fetch saved ActUpon items, including signed source image URLs.
- API: Inbox: https://actupon.app/docs/api/inbox - Query pending workflow items for agent-style processing loops.
- API: Agent Tokens: https://actupon.app/docs/api/agent-tokens - Create scoped personal agent tokens and understand bearer auth.
- Integrations: https://actupon.app/docs/integrations - Current destination model for Todoist, Linear, Notion, and webhooks.

Key endpoints:
- GET https://actupon.app/api/screenshotaction/items
- GET https://actupon.app/api/screenshotaction/items/{id}
- PATCH https://actupon.app/api/screenshotaction/items/{id}
- GET https://actupon.app/api/screenshotaction/inbox
- GET https://actupon.app/api/screenshotaction/agent-tokens
- POST https://actupon.app/api/screenshotaction/agent-tokens

Agent inbox routing:
- Structured tags like codex, codex:<lane>, cursor, and cursor:<lane> are the preferred routing signal.
- Notes are freeform human context; agents should use exact tag matching for retrieval and routing.
- If a user types @codex or @cursor in the note, the UI should promote that input into the structured tag list before save.
- Legacy note-marker parsing remains a temporary compatibility fallback, but new integrations should not rely on it.

OpenAPI: https://actupon.app/openapi.json