ActUpon public integration docs
These pages describe the stable public contract for ActUpon users, agents, and downstream tools. They are written to be consumed by humans and machine agents.
What is documented here
This public docs surface covers bearer authentication, item retrieval, agent inbox workflows, and the current destination model for ActUpon integrations.
Internal architecture, deployment notes, and worktree-specific runbooks remain in the private repository docs.
Machine-readable entrypoints
llms.txt
/llms.txt is the short discovery index for agent tools.
llms-full.txt
/llms-full.txt expands the contract summary with auth and endpoint guidance.
OpenAPI
/openapi.json publishes the first API slice for items, inbox, and agent tokens.
API base
Use the app origin and prefix all API calls with /api/screenshotaction.
First pages to read
Quickstart
Token model, first API calls, and the shortest path to a working integration.
Agent Inbox
How to route captures to Codex, Cursor, or other local agent workflows.
API: Items
List and fetch saved ActUpon items, including signed source image URLs.
API: Inbox
Query pending workflow items for agent-style processing loops.
API: Agent Tokens
Create scoped personal agent tokens and understand bearer auth.
Integrations
Current destination model for Todoist, Linear, Notion, and webhooks.
Current public contract
ActUpon currently exposes these public integration primitives:
- Scoped bearer auth through personal agent tokens.
- Saved item retrieval with signed source image URLs.
- Workflow inbox retrieval for agent-style claim and done loops.
- Agent inbox routing via explicit markers like
@codexand@cursor. - Workflow destinations including Todoist, Linear, Notion, and webhooks.