Referencia de la API

API programática de FIA Copilot. Acceso para planes pagos vía API key; los alumnos de FIA Agéntica tienen acceso limitado a los scopes agentica:read / agentica:write (Copiloto FIA Agéntica). Cada key accede solo a la data de su dueño.

Base URLhttps://fiacopilot.com/api/v1
AuthAuthorization: Bearer fia_sk_…oX-API-Key: fia_sk_…

Identidad

get/me

Identidad del dueño de la key

Respuestas

200OK
401Falta o es inválida la API key

Ejemplo

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

Memoria

get/memory

Lista la memoria

Parámetros

typequerystring
starredquerystring(true)
tagquerystring
capsule_idquerystring
qquerystring
limitqueryinteger
offsetqueryinteger

Respuestas

200Lista de items
401Falta o es inválida la API key
403Scope insuficiente o rol no autorizado

Ejemplo

curl https://fiacopilot.com/api/v1/memory \
  -H "Authorization: Bearer fia_sk_..."
post/memory

Crea un item de memoria

Body (requerido)

contentstringrequerido
titlestring
content_typestring
tagsarray
is_starredboolean

Respuestas

201Creado
400Datos inválidos
401Falta o es inválida la API key
403Scope insuficiente o rol no autorizado

Ejemplo

curl -X POST https://fiacopilot.com/api/v1/memory \
  -H "Authorization: Bearer fia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"content":"..."}'
get/memory/{id}

Un item de memoria

Parámetros

idpathstringrequerido

Respuestas

200OK
404No existe o no es tuyo

Ejemplo

curl https://fiacopilot.com/api/v1/memory/:id \
  -H "Authorization: Bearer fia_sk_..."

Procesos

get/processes

Procesos (memoria context_process)

Respuestas

200OK
403Scope insuficiente o rol no autorizado

Ejemplo

curl https://fiacopilot.com/api/v1/processes \
  -H "Authorization: Bearer fia_sk_..."

Cápsulas

get/capsules

Cápsulas + paths que podés ver (según tus programas y su goteo; locked=true sin video)

Respuestas

200OK
403Scope insuficiente o rol no autorizado

Ejemplo

curl https://fiacopilot.com/api/v1/capsules \
  -H "Authorization: Bearer fia_sk_..."
get/capsules/progress

Tu progreso en cápsulas

Respuestas

200OK

Ejemplo

curl https://fiacopilot.com/api/v1/capsules/progress \
  -H "Authorization: Bearer fia_sk_..."
post/capsules/progress

Marca una cápsula como completada (scope agentica:write o memory:write)

Body (requerido)

capsule_idstring
slugstring

Respuestas

200OK
403Scope insuficiente o rol no autorizado
404No existe o no es tuyo

Ejemplo

curl -X POST https://fiacopilot.com/api/v1/capsules/progress \
  -H "Authorization: Bearer fia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"capsule_id":"...","slug":"..."}'

agentica

get/agentica/estado

FIA Agéntica: semana liberada, pendientes, próximo evento (scope agentica:read)

Respuestas

200OK
403Scope insuficiente o rol no autorizado

Ejemplo

curl https://fiacopilot.com/api/v1/agentica/estado \
  -H "Authorization: Bearer fia_sk_..."
get/agentica/bitacora

FIA Agéntica: tu bitácora sincronizada (scope agentica:read)

Respuestas

200OK

Ejemplo

curl https://fiacopilot.com/api/v1/agentica/bitacora \
  -H "Authorization: Bearer fia_sk_..."
put/agentica/bitacora

FIA Agéntica: sincroniza la bitácora (scope agentica:write)

Body (requerido)

semana_actualintegerrequerido

Respuestas

200OK
400semana_actual requerida
403Scope insuficiente o rol no autorizado

Ejemplo

curl -X PUT https://fiacopilot.com/api/v1/agentica/bitacora \
  -H "Authorization: Bearer fia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"semana_actual":0}'
post/agentica/ayuda

FIA Agéntica: pedido de ayuda al CSM (y opcional a la comunidad) (scope agentica:write)

Body (requerido)

mensajestringrequerido
titulostring
semanainteger
contextoobject
publicar_en_comunidadboolean

Respuestas

200OK
403Scope insuficiente o rol no autorizado
429demasiados_pedidos_hoy

Ejemplo

curl -X POST https://fiacopilot.com/api/v1/agentica/ayuda \
  -H "Authorization: Bearer fia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"mensaje":"..."}'

Briefings

get/briefings

Lista tus briefings

Respuestas

200OK
403Scope insuficiente o rol no autorizado

Ejemplo

curl https://fiacopilot.com/api/v1/briefings \
  -H "Authorization: Bearer fia_sk_..."
post/briefings

Crea un briefing

Body (requerido)

titlestringrequerido
instructionsstring
included_outputsarray
included_business_contextarray
include_profileboolean
include_diagnosticoboolean
expires_atstring | null
max_viewsinteger | null
passwordstring | null
public_on_profileboolean

Respuestas

201Creado (devuelve id, token, url)
400title_required
403Scope insuficiente o rol no autorizado

Ejemplo

curl -X POST https://fiacopilot.com/api/v1/briefings \
  -H "Authorization: Bearer fia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"..."}'
get/briefings/{id}

Un briefing

Parámetros

idpathstringrequerido

Respuestas

200OK
404No existe o no es tuyo

Ejemplo

curl https://fiacopilot.com/api/v1/briefings/:id \
  -H "Authorization: Bearer fia_sk_..."
patch/briefings/{id}

Edita/revoca un briefing

Parámetros

idpathstringrequerido

Body

statusstring
instructionsstring
expires_atstring | null
max_viewsinteger | null
public_on_profileboolean

Respuestas

200OK
404No existe o no es tuyo

Ejemplo

curl -X PATCH https://fiacopilot.com/api/v1/briefings/:id \
  -H "Authorization: Bearer fia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"status":"...","instructions":"..."}'
get/briefings/{id}/executions

Logs de ejecución del briefing

Parámetros

idpathstringrequerido

Respuestas

200OK
404No existe o no es tuyo

Ejemplo

curl https://fiacopilot.com/api/v1/briefings/:id/executions \
  -H "Authorization: Bearer fia_sk_..."
post/briefings/{id}/executions

Deja un log de ejecución

Parámetros

idpathstringrequerido

Body (requerido)

summarystringrequerido
agentstring
outputstring

Respuestas

201Creado
404No existe o no es tuyo

Ejemplo

curl -X POST https://fiacopilot.com/api/v1/briefings/:id/executions \
  -H "Authorization: Bearer fia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"summary":"..."}'

Equipo

get/team

Roster del equipo + resumen

Respuestas

200OK
403Scope insuficiente o rol no autorizado

Ejemplo

curl https://fiacopilot.com/api/v1/team \
  -H "Authorization: Bearer fia_sk_..."
get/team/{memberId}

Detalle de un miembro

Parámetros

memberIdpathstringrequerido

Respuestas

200OK
403Scope insuficiente o rol no autorizado
404No existe o no es tuyo

Ejemplo

curl https://fiacopilot.com/api/v1/team/:memberId \
  -H "Authorization: Bearer fia_sk_..."

¿Preferís que tu agente lo opere solo? Pegale el prompt para tu agente y dejá que use estos endpoints por vos.