Skip to content
BordioBordio Documentation

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

Section titled “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

Section titled “2. Make your first request”

Send the key as a bearer token. The shortest call tells you which workspace the credentials belong to:

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

A successful response is wrapped in a data envelope:

{
  "data": {
    "id": "ws_6594a1b2c3d4e5f6a7b8c9e1",
    "name": "Acme Inc.",
    "timezone": "Europe/Berlin",
    "created_at": "2026-06-25T10:00:00.000Z"
  }
}

List endpoints wrap the same way and add a pagination block:

Terminal window
curl https://api.bordio.com/public/v1/tasks \
  -H "Authorization: Bearer brd_sk_live_..."
{
  "data": [
    { "id": "task_6a2918cff58b0a1d387866ee", "title": "Ship the API", "priority": "high" }
  ],
  "pagination": { "next_cursor": null, "has_more": false }
}

3. Next steps

Section titled “3. Next steps”