All docs
Developers

REST API

Read and write your workspace data over HTTP with a workspace API key.

Zetadeck has a REST API for reading and writing your workspace data from scripts, automations, or other tools.

Get a key. Go to Settings, Advanced, API Keys and generate one. Choose Read only, or Read and write to also create records. Copy the key (shown once). Keys are scoped to the one workspace they were created in.

Authenticate. Send the key as a bearer token on every request: Authorization: Bearer zd_live_your_key_here

Base URL. All endpoints live under /api/v1.

Endpoints.

  • GET /api/v1 confirms your key and lists endpoints.
  • GET /api/v1/tasks lists tasks. Query params: status, limit (max 200).
  • POST /api/v1/tasks creates a task (write scope). Body: title (required), description, status, priority, due_date.
  • GET /api/v1/clients lists pipeline records. Query params: status, limit.
  • POST /api/v1/clients creates a pipeline record (write scope). Body: name (required), company, contact_email, status, mrr, notes.
  • GET /api/v1/finance returns cash, monthly burn, and runway from your latest snapshot.

Example. curl -H "Authorization: Bearer zd_live_..." https://zetadeck.com/api/v1/finance

Notes. Responses are JSON. A read-only key gets 403 on write endpoints. Revoke a key any time from the same settings page and it stops working immediately.

Ready to try it?

Free workspace in minutes. No credit card required.