REST API reference

Qone exposes a REST API for everything you can do in the UI.

Base URL

https://api.qone.work/v1

Authentication

Bearer token via Authorization: Bearer <token>. Create one at Settings → Developer → API tokens.

Rate limits

• Read endpoints: 120 req/min per token
• Write endpoints: 60 req/min per token
• 429 responses include Retry-After seconds

Common endpoints

• GET /tasks — list tasks (cursor pagination)
• POST /tasks — create a task
• PATCH /tasks/:id — update fields
• GET /projects — list projects
• POST /webhooks — register an outbound webhook

Webhooks

Signed with HMAC-SHA256 using your webhook secret. Verify the X-Qone-Signature header before processing.

MCP server

Compatible with the Model Context Protocol. Connect from Claude Desktop, Cursor, or any MCP-aware client at https://mcp.qone.work/v1/sse.