Skip to content
AppHandoff Docs
Search
Ctrl
K
Cancel
AppHandoff
Select theme
Dark
Light
Auto
Getting Started
Authentication — API keys, OAuth, and MCP sessions
Quick start — Cursor MCP setup and project bootstrap
MCP
Connect MCP — hosted MCP server for AI coding agents
Handoff tickets — AI agent handoff on shared Kanban
REST API
Overview
Auth
Overview
Check authentication and approval status
Sign out the current session
Dev/staging password login
Exchange Supabase tokens for session cookies
GitHub OAuth redirect
Email and password sign-in
Get authenticated user info
Refresh access token
Send password reset email
Send passwordless magic link
Email + password sign-up
User
Overview
Get current user profile
Update current user profile
Get current user portal preferences
Merge current user portal preferences
List assignable ticket roles
Get current user email notification preferences
Update email notification preferences
Keys
Overview
List API keys
Create an API key
Get API key details
Revoke an API key
Projects
Overview
List user's projects
Create or link a project
Get project detail with runs
Delete a project and all associated data
Update project settings
Check if source repo is ahead of last run
MCP session snapshot for portal Kanban presence
List active/recent agent sessions for a project
Agent activity for multiple projects
Look up target repo by source repo
Get OpenAPI spec from latest backend scan
Get DB schema from latest backend scan
List in-app documentation index for portal sidebar
Get one in-app documentation article by slug
Frontend/backend mismatch summary
GPT-powered app analysis
MCP tool call analytics for a project
Send a turn to the shared project assistant chat
Subscribe current user to all tickets in the project
Current user's project watch status
Soft-unsubscribe from project-wide watch
BackendGaps
Overview
Project overview (scans + open handoff count)
List handoff tickets for a project
Create a handoff ticket
Batch move or close handoff tickets
Batch update ticket stage
Get a single handoff ticket
Delete a handoff ticket
Update a handoff ticket
List messages for a ticket
Human posts a message to a ticket thread
[REMOVED] Use /shipping instead
List human test cases for a ticket
Generate cached human test cases (test stage only)
Approve or decline a human test case
Per-ticket activity timeline
Get linked GitHub issue for a ticket
Create a GitHub issue from a handoff ticket
Submit plan review (approve/request_changes/deny)
Trigger bot build phase for a ticket
SSE stream for real-time ticket updates
List all handoff tickets across user's projects
Consolidated handoff audit feed
Batch-fetch GitHub issue statuses
Tools
Overview
List project's foreign tools
Add a foreign tool from template
Update tool config or enable/disable
Remove a tool from the project
Audit log for tool calls
Test tool connection via dry-run
Discover and register tools from remote MCP server
Get MCP tool enable/disable state
Set MCP tool enable/disable state
Get tool usage stats (last 7 days)
Record tool usage event
List available foreign tool templates
Rules
Overview
List project rules
Create a project rule
Delete a project rule
Update a project rule
Runs
Overview
List conversion runs
Scan
Overview
Scan backend and Lovable repos
List scan event history
Trigger a rescan for a project
Get a single scan event by ID
GitHub
Overview
List user's GitHub repos
Check GitHub connection status
GitHub connection overview
Get GitHub App installation URL
GitHub App installation callback
Persist GitHub App installation after portal redirect
Uninstall GitHub App for the current account
GitHub webhook installation status
Install GitHub webhook
Billing
Overview
Create a Stripe Checkout session
Create a Stripe Billing Portal session
Get billing summary
Get billing insights
Team
Overview
List team members
Remove a team member (admin only)
List pending join requests (admin only)
Approve or reject a join request (admin only)
Invite a user to the team
List team invitations (owner only)
Accept an invitation by token
Revoke a pending invitation (owner only)
Re-send invitation email (rate-limited, max once per 5 min)
Force-accept a pending invitation (owner only)
Get project allowlist for a team member (admin only)
Set project allowlist for a team member (admin only)
Get project access for all team members
Set project access for a team member by request body (admin only)
Admin
Overview
List all users (super admin only)
Create a user (super admin only)
Delete a user (super admin only)
Update a user (super admin only)
List all beta invites (super admin only)
Update invite status and send email (super admin only)
List all conversion runs (super admin only)
MCP tool call analytics (superadmin only)
List admin activity logs (super admin only)
Unified ticket activity log (super admin only)
MCP dashboard metrics and sessions (superadmin only)
Toggle superadmin status for a user (superadmin only)
Self-service superadmin toggle (admin role required)
Backfill ticket embeddings for vector similarity search
Health
Overview
App health check
Request metrics snapshot
Deep dependency health check
Minimal liveness ping
Public status indicator for the marketing site
Public build and version metadata
Public uptime stats from UptimeRobot
MCP
Overview
MCP server endpoint (GET)
MCP server endpoint (POST)
MCP server endpoint (DELETE)
MCP CORS preflight
MCP server health for dashboard
CORS preflight
Public MCP diagnostics
CORS preflight
MCP ping (no auth)
REST list of MCP tools
CORS preflight
MCP Playground tool execution (JSON-RPC tools/call bridge)
CORS preflight
Deep health check with per-dependency status
CORS preflight
Unauthenticated health probe (no session required)
CORS preflight
MCP OAuth token endpoint proxy (authorization_code + refresh_token)
CORS preflight
MCP inspector OAuth token exchange proxy
CORS preflight
OAuth
Overview
OAuth consent proxy
OAuth consent decision (approve/deny)
RFC 7591 Dynamic Client Registration
CORS preflight
MCP OAuth token endpoint proxy (authorization_code + refresh_token)
CORS preflight
MCP inspector OAuth token exchange proxy
CORS preflight
Cron
Overview
Backfill done tickets to complete stage
Record health snapshot (GET for UptimeRobot)
Record health snapshot (POST)
Rescan stale projects
Pump Cursor cloud-agent lanes
Reclaim expired agent-run lease lanes (GET)
Reclaim expired agent-run lease lanes (POST)
Emit stale in-progress handoff notifications (GET)
Emit stale in-progress handoff notifications (POST)
Repair merged handoff role when merged_at is set (GET)
Repair merged handoff role when merged_at is set (POST)
Submit URLs to IndexNow
Sweep email outbox and send digest emails (GET)
Sweep email outbox and send digest emails (POST)
Webhooks
Overview
GitHub webhook handler
Stripe webhook handler
Cursor Cloud agent webhook handler
Settings
Overview
List available RBAC roles
Update enabled RBAC roles for the account
Internal
Overview
List analyzer-backed AI suggestions
Execute or decline an AI suggestion
Audit log with filtering
Combined dashboard reads in one pass
Aggregate dashboard stats
Batch per-project stats for dashboard
List user notifications
Mark notifications as read
Debug endpoint (no auth)
Receive Playwright session events and broadcast via Realtime
CORS preflight for dev events
List active Playwright dev sessions
CORS preflight for dev sessions
List integrations (projects) for portal
Batched payload for the portal Integrations page
List webhooks for integrations
Auto-setup GitHub webhooks for user projects
Webhook setup metadata for manual GitHub configuration
Webhook health across user projects
Return GitHub webhook HMAC secret for manual setup
Issue single-use SSE auth nonce
OpenAPI spec (main)
OpenAPI spec (projects subset)
Get auto-close analyzer settings
Update auto-close analyzer settings
Agents
Overview
Create an agent plan from a milestone + selected tickets
Get an agent plan and its spawned run lanes
List agent plans for a project
Approve a plan and spawn its run lanes (idempotent)
Reject a pending plan with a reason
List registered execution workers (agent bridge)
List agent run lanes (monitor snapshot)
Report worker telemetry for a run lane (heartbeat + events)
Milestones
List milestones for a project with ticket progress
Create a milestone for a project
Reorder milestones for a project
Set a milestone's horizon and reorder milestones
Get a single milestone with ticket progress
Delete a milestone
Update a milestone
Tasks
List tasks for a ticket
Create a new task on a ticket
Get a single task
Delete a task
Update a task
Reorder tasks by providing ordered task IDs
Tickets
Get canonical shipping status for a ticket
List watchers for a ticket
Self-watch or invite others to watch a ticket
Unwatch a ticket (or mute project-wide subscription)
RoadmapCheck
List past roadmap checks for a project
Upload a roadmap file (or paste text) and start the comparison pipeline
Poll status and results of a roadmap check
List requirement suggestions and AI analysis for a check
Approve, reject, or edit a single requirement suggestion
Apply all approved/edited suggestions — create or update tickets and milestones
Public
Public changelog from central infra release notes
Analytics
Historical MCP tool call analytics with aggregation
Team-scoped MCP error and event logs
Realtime MCP metrics
AppHandoff
Select theme
Dark
Light
Auto
Overview
Runs
Section titled “Runs”
Scan and conversion run history per project (linked from project summaries)
Operations
Section titled “ Operations ”
GET
/runs
