Developer API

Build your own interface to Queuevia.

Use personal API keys to create tasks, manage projects, read stats, automate reviews, connect webhooks, and capture raw ideas into your GTD system.

Quickstart Create an account
POST /api/v1/tasks
curl -X POST https://queuevia.app/api/v1/tasks \
  -H "X-API-Key: qv_live_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Follow up with Sarah","status":"next","today":true}'
Personal keys

Keys are shown once and stored hashed. Rotate or revoke them from Profile → Developer API.

Scoped access

Grant only what each integration needs: read, write, AI capture, stats, reviews, or webhooks.

Audited + rate limited

Each key has per-minute limits and API actions are recorded for inspection.

Quickstart

Three steps to your first request.

1
Create an API key
Log in, open Profile → Developer API, choose scopes, and copy the key once.
2
Send the key
Use `X-API-Key` or `Authorization: Bearer` on every `/api/v1` request.
3
Build safely
Use the narrowest scopes, rotate keys regularly, and revoke keys no longer in use.
Endpoint coverage

Most of Queuevia, from your code.

Start building
GET/api/v1/meInspect the API key owner and scopes
GET/api/v1/tasksList Inbox, Today, Next, Waiting, Someday, or filtered tasks
POST/api/v1/tasksCreate tasks from automations, CLIs, or other apps
PATCH/api/v1/tasks/{task_id}Update status, Today star, project, context, due dates, notes
DELETE/api/v1/tasks/{task_id}Delete a task
GET/api/v1/projectsList projects
POST/api/v1/projectsCreate projects
PATCH/api/v1/projects/{project_id}Update project metadata and review settings
DELETE/api/v1/projects/{project_id}Delete or unfile project tasks
GET/api/v1/contactsList contacts used for Waiting For
POST/api/v1/contactsCreate contacts
GET/api/v1/workspacesList workspaces available to the key owner
GET/api/v1/reviews/projects/queueFetch due project-review queue
POST/api/v1/reviews/projects/{project_id}/mark-reviewedMark a project reviewed
GET/api/v1/statsRead personal productivity stats
POST/api/v1/ai/captureTurn raw text into actionable Queuevia items
GET/api/v1/webhooksList configured webhooks
POST/api/v1/webhooksCreate outbound webhooks
Scopes

Grant exactly what an app needs.

Use read-only keys for dashboards, write-scoped keys for automations, and combined scopes for trusted internal tools.

tasks:readtasks:writeprojects:readprojects:writecontacts:readcontacts:writeworkspaces:readworkspaces:writereviews:readreviews:writestats:readai:capturewebhooks:readwebhooks:write

Ready to connect Queuevia?

Create a scoped key and build the workflow your team already wanted.

Create accountLog in