En resumen: el dueño del espacio de trabajo crea una clave de API en BOSS en Configuración, Conectores, API. Envíela como Authorization: Bearer boss_... a https://app.bossforteams.com/api/v1. Las claves son de solo lectura o de lectura y escritura. La API es parte del plan Pro.
Para empezar
- En BOSS, abra Configuración, Conectores, y busque API, Zapier y Power Automate.
- Ponga un nombre a la clave, elija solo lectura o lectura y escritura, y haga clic en el botón para crear la clave. Cópiela de inmediato: solo se muestra una vez.
- Llame a
GET /api/v1/mepara comprobar que funciona.
Una clave sirve para todo el espacio de trabajo. Nunca devuelve reuniones generales privadas, evaluaciones de personas ni conversaciones de reuniones que se apartaron por ser personales. Revoque una clave cuando quiera y deja de funcionar de inmediato, junto con sus webhooks.
Endpoints
| Solicitud | Qué hace |
|---|---|
GET /me | El nombre del espacio de trabajo, el nombre de la clave y si puede escribir. |
GET /teams | Equipos, empezando por Everyone. |
GET /people | Personas activas con nombre, correo, función y equipos. |
GET /todos?status=open|done|all&team=&owner=email&limit= | Tareas, de la más reciente a la más antigua. Abiertas por defecto. |
POST /todos | Agrega una tarea: title, owner_email, due_date opcional (YYYY-MM-DD, por defecto a una semana) y team (nombre, por defecto Everyone). |
PATCH /todos/{id} | Cambia title, due_date o done. |
GET /issues?status=open|solved|all&team= | Asuntos, del más reciente al más antiguo. |
POST /issues | Agrega un asunto: title, details opcional, owner_email, team. |
PATCH /issues/{id} | Cambia title, details o status (open o solved). |
GET /priorities?quarter=2026-Q4 | Prioridades trimestrales con responsable, equipo y estado. Por defecto, el trimestre actual. |
GET /measurables | Números del scorecard con meta, responsable y los valores de las últimas 13 semanas. |
PUT /measurables/{id}/values/{date} | Registra un número para la semana que contiene date: cuerpo {"value": 42}. Los números que llena un conector o una fórmula no se pueden registrar. |
GET /meetings?limit=20 | Reuniones terminadas con calificación, asistentes, titulares y el resumen. |
GET /hooks | Webhooks creados con esta clave. |
POST /hooks | Suscribirse: event y url. Devuelve el id y un secreto de firma. |
DELETE /hooks/{id} | Cancelar la suscripción. |
Ejemplos
Listar tareas abiertas
curl -H "Authorization: Bearer boss_YOUR_KEY" \ https://app.bossforteams.com/api/v1/todosAgregar una tarea
curl -X POST https://app.bossforteams.com/api/v1/todos \ -H "Authorization: Bearer boss_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"title":"Llamar al banco","owner_email":"pat@company.com","due_date":"2026-11-07"}'Registrar un número del scorecard para esta semana
curl -X PUT https://app.bossforteams.com/api/v1/measurables/NUMBER_ID/values/2026-10-29 \ -H "Authorization: Bearer boss_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"value": 48250}'Webhooks
Suscríbase a todo.created, todo.completed, issue.created o meeting.ended. BOSS envía JSON a su dirección:
{ "event": "todo.created", "at": "2026-10-29T14:02:11.000Z", "data": { "id": "...", "title": "Llamar al banco", "owner": { "name": "Pat Lee", "email": "pat@company.com" }, "team": "Everyone", "due_date": "2026-11-07", "done": false } }Cada envío lleva X-Boss-Event y X-Boss-Signature: sha256=..., un HMAC-SHA256 del cuerpo sin procesar con el secreto que recibió al suscribirse. Responda con cualquier código 2xx. Responda 410 para cancelar la suscripción. Un webhook que falla 50 veces seguidas se elimina. Las direcciones deben ser direcciones https públicas.
Zapier, Power Automate y Make
En Power Automate o Make, use un paso HTTP con su clave en el encabezado Authorization, o un disparador de webhook suscrito con POST /hooks. Pronto habrá una app de BOSS para Zapier con estos disparadores y acciones.
Límites y errores
- Hasta 120 solicitudes por minuto por clave, y hasta 50 webhooks por espacio de trabajo.
- Los errores llegan como
{"error": {"code": "...", "message": "..."}}con un estado 4xx: 401 si falta la clave o fue revocada, 403 si una clave de solo lectura intenta escribir, 404 para un elemento desconocido, 429 si va demasiado rápido. - Las listas devuelven hasta 500 elementos; use
limitpara pedir menos.
Apps de IA
Para usar BOSS desde Claude, ChatGPT u otra app de IA, no necesita una clave. Agregue BOSS como conector personalizado con la dirección https://app.bossforteams.com/mcp e inicie sesión cuando se lo pida. La app solo ve lo que usted puede ver en BOSS.
Preguntas
¿BOSS tiene una API?
Sí. BOSS tiene una API REST en https://app.bossforteams.com/api/v1 con claves de API del espacio de trabajo, para tareas, asuntos, prioridades, números del scorecard, reuniones y personas, además de webhooks. Es parte del plan Pro.
¿BOSS puede enviar webhooks?
Sí. Suscríbase a todo.created, todo.completed, issue.created o meeting.ended y BOSS envía JSON firmado a su dirección https.
¿Puedo conectar BOSS a Claude o ChatGPT?
Sí. Agregue un conector personalizado con la dirección https://app.bossforteams.com/mcp e inicie sesión en BOSS. Solo ve lo que usted puede ver.