The distro HTTP API

Agency tier includes API access — programmatic read/write against your workspace. Useful for wiring distro into existing tooling (custom dashboards, build pipelines, portfolio reporting).

Authentication

Bearer token. Create a Personal Access Token at Settings → API → Tokens. Tokens scope to specific apps (optional) and operations (read / write).

curl https://api.distro.digital/v1/ideas \
  -H "Authorization: Bearer <token>"

Endpoints (summary)

• GET /v1/apps — list your apps
• GET /v1/apps/:slug — single app detail
• GET /v1/ideas?app=:slug&stage=INBOX — list ideas
• POST /v1/ideas — capture a new idea
• POST /v1/ideas/:id/evaluate — trigger evaluation
• POST /v1/ideas/:id/repurpose — generate drafts
• GET /v1/drafts?app=:slug — list drafts
• POST /v1/posts — record a published post (triggers post-mortem in 48h)
• GET /v1/posts/:id/mortem — post-mortem result
• GET /v1/analytics?app=:slug&range=30d — analytics data

Rate limits

60 requests per minute per token. 10k requests per day. Heavy operations (evaluate, repurpose) count as 5 each. Exceeding either limit returns 429 with a Retry-After header.

Webhooks

Subscribe to events at Settings → API → Webhooks. Available events:

• idea.captured, idea.evaluated, idea.moved
• draft.generated, draft.saved
• post.published, post.mortem_ready
• review.received, review.completed

Deliveries are signed (HMAC-SHA256) using your webhook secret. Retries with exponential backoff on 5xx responses.

SDKs

No official SDK yet. Community packages for Node, Python, Ruby are in the works. The API is simple enough that curl / fetch works fine.