Shortcut API
REST API for Shortcut (formerly Clubhouse), a project management platform for engineering teams, covering stories, epics, iterations, workflows, and members.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
HTTPS enforced. However, no OAuth or scope granularity — every token is full-access. SOC2 certified. Agents should use dedicated accounts with tokens rotated regularly.
⚡ Reliability
Best When
An engineering team uses Shortcut and agents need to automate story creation, triage, or workflow state management.
Avoid When
Your team doesn't use Shortcut or prefers a GraphQL-first API for richer query flexibility.
Use Cases
- • Creating stories and epics from automated agent workflows
- • Syncing incidents or alerts into Shortcut as actionable stories
- • Querying iteration (sprint) progress and team velocity
- • Automating story state transitions and workflow management
- • Building reporting tools on top of Shortcut project data
Not For
- • Teams already invested in Jira or Linear ecosystems
- • Non-engineering project management (limited support for non-dev workflows)
- • Organizations needing self-hosted project management
Interface
Authentication
Single API token per user; token passed via Shortcut-Token header. No OAuth or fine-grained scoping — all tokens have full account access. Treat tokens as high-privilege secrets.
Pricing
API access available on all tiers. Free tier is generous for small teams. Enterprise pricing includes SSO and advanced controls.
Agent Metadata
Known Gotchas
- ⚠ No OAuth — all tokens are full-access; agents should use dedicated service-user tokens
- ⚠ Rate limit of 200 req/min can be hit by agents processing large backlogs
- ⚠ No idempotency keys: retried story-creation calls will create duplicates
- ⚠ Workflow states are workspace-specific IDs that must be looked up before use
- ⚠ OpenAPI spec exists but may lag behind the actual API — validate against live docs
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Shortcut API.
Scores are editorial opinions as of 2026-03-06.