Quickstart

The Bordio API gives you programmatic access to your workspace — tasks, events, projects and definitions — over a simple REST interface.

1. Get an API key

Create a secret key in your Bordio workspace settings. Each key is scoped: read or read-write, over a whole workspace or a single project. Keys look like brd_sk_live_….

2. Make your first request

Send the key as a bearer token:

curl https://api.bordio.com/public/v1/tasks \
  -H "Authorization: Bearer brd_sk_live_..."

A successful response is wrapped in a data envelope:

{
  "data": [
    { "id": "task_6a2918cff58b0a1d387866ee", "title": "Ship the API", "priority": "high" }
  ],
  "pagination": { "next_cursor": null, "has_more": false }
}

3. Next steps

Authentication — keys, scopes and headers.
Conventions — envelopes, pagination, idempotency.
Errors — how failures are reported.
API Reference — every endpoint, with a built-in request runner.