FIA Copilot/Documentación
Iniciar sesión

API de FIA Copilot

La API te deja operar tu FIA Copilot por programa en lugar de navegar la app: leer y escribir tu memoria, tus procesos, tus briefings (y los logs de lo que hicieron los agentes), y —si sos sponsor o implementador— ver el progreso de tu equipo.

Es la base sobre la que después se conecta el MCP, para que Claude, ChatGPT, n8n o tu propio código operen tu cuenta directamente.

Base URL

https://fiacopilot.com/api/v1

Requisitos

Principios

  • Aislamiento por usuario. Cada API key pertenece a un solo usuario y solo accede a su información. La única excepción es /team, que respeta exactamente los mismos permisos que el tablero Mi equipo (sponsor/implementador viendo a su propia organización).
  • Permisos granulares (scopes). Cada key puede limitarse a ciertas acciones (ej. solo leer memoria). Ver Autenticación.
  • Todo queda registrado. Cada llamada se audita y la podés ver en la pantalla de actividad de tus keys.

Primer llamado

curl https://fiacopilot.com/api/v1/me \
  -H "Authorization: Bearer fia_sk_tu_key"

Respuesta:

{
  "data": {
    "userId": "…",
    "name": "Tu Nombre",
    "org": { "id": "…", "name": "Tu Empresa" },
    "orgRole": "sponsor",
    "plan": { "status": "active", "planId": "pro" },
    "scopes": []
  }
}

scopes: [] significa acceso total a tu data. Si la key tiene scopes limitados, vas a verlos acá.

Formato de respuestas

  • Un recurso: { "data": { … } }
  • Una lista: { "data": [ … ], "page": { "limit": 50, "offset": 0, "total": 12 } }
  • Error: { "error": "codigo_de_error" } con el HTTP status correspondiente.

Mapa de endpoints

Recurso Endpoints Doc
Identidad GET /me esta página
Memoria GET /memory, GET /memory/{id}, POST /memory Memoria y procesos
Procesos GET /processes Memoria y procesos
Briefings GET/POST /briefings, GET/PATCH /briefings/{id}, GET/POST /briefings/{id}/executions Briefings y logs
Cápsulas GET /capsules, GET /capsules/progress Referencia
Equipo GET /team, GET /team/{memberId} Referencia

La referencia completa de endpoints (métodos, parámetros, body, respuestas y ejemplos copiables) está en Referencia de endpoints. La especificación máquina-legible está en /openapi.json.