Inicio rápido

La API de Bordio te da acceso programático a tu espacio de trabajo — tareas, eventos, proyectos y definiciones — a través de una sencilla interfaz REST.

1. Obtén una clave de API

Crea una clave secreta en la configuración de tu espacio de trabajo de Bordio. Cada clave tiene un alcance: lectura o lectura-escritura, sobre un espacio de trabajo completo o un único proyecto. Las claves tienen el aspecto brd_sk_live_….

2. Realiza tu primera solicitud

Envía la clave como un token bearer. La llamada más corta te dice a qué espacio de trabajo pertenecen tus credenciales:

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

Una respuesta correcta se envuelve en un envoltorio data:

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

Los endpoints de listado se envuelven igual y añaden un bloque 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 pasos

Autenticación — claves, alcances y cabeceras.
Convenciones — envoltorios, paginación, idempotencia.
Errores — cómo se reportan los fallos.
Referencia de la API — todos los endpoints, con un ejecutor de solicitudes integrado.