Início rápido

A API do Bordio fornece acesso programático ao seu espaço de trabalho — tarefas, eventos, projetos e definições — por meio de uma interface REST simples.

1. Obtenha uma chave de API

Crie uma chave secreta nas configurações do seu espaço de trabalho no Bordio. Cada chave tem escopo: leitura ou leitura-escrita, sobre um espaço de trabalho inteiro ou um único projeto. As chaves se parecem com brd_sk_live_….

2. Faça sua primeira requisição

Envie a chave como um token bearer. A chamada mais curta mostra a qual workspace as credenciais pertencem:

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

Uma resposta bem-sucedida é encapsulada em um envelope data:

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

Endpoints de listagem são encapsulados da mesma forma e adicionam um bloco pagination:

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. Próximos passos

Autenticação — chaves, escopos e cabeçalhos.
Convenções — envelopes, paginação, idempotência.
Erros — como as falhas são reportadas.
Referência da API — todos os endpoints, com um executor de requisições integrado.