End-to-end walkthroughs for the common flows, with curl, JavaScript, C# and Python. For per-endpoint details and a live "Try It", see the reference.
| Guide | What you'll do |
|---|---|
| Authenticate & verify | Create a key, send it as a Bearer token, confirm with GET /me. |
| Create a task — plain or from an email | Walk team → board → list, then create a task — composed by hand, or straight from an email thread (title from the subject). |
| Order & reorder tasks | Place tasks at create/move time, reposition them, and impose a full priority order (e.g. from an AI prioritiser). |
| Poll for new mail | The per-key new-mail feed: server-side cursor, headers-only, and the new_mail_expired recovery flow. |
| Drafts & sending email | The four-scope send ladder: drafts for review, approve-by-sending, no-leak replies, full compose. |
| Classify a thread with AI | Request a classification, handle the cached-or-202 flow, poll for the result. |
| Receive webhooks | Subscribe to events and verify the signed delivery (HMAC-SHA256). |
Connecting an AI assistant instead of writing code? Start at Connect your AI and the MCP tool catalog.
Every request needs Authorization: Bearer sk_live_…. All examples use https://api.sortd.com/v2; replace placeholders in <angle brackets> with your own values.