REFERENCIA API
REFERENCIA API AGORA
API REST para crear tareas, consultar estado e integrar con el servicio de agentes.
AUTENTICACIÓN
Todas las solicitudes API requieren el header X-API-Key con tu API key secreta.
X-API-Key: tu-api-key-secretaENDPOINTS
Crear una nueva tarea de marketing. El Jefe de Gabinete clasifica la solicitud y enruta al CMO. Devuelve taskId y respuesta inicial.
Body: { message: string, taskId?: string, target_market_id?: string }
Response: { taskId, response, approvalNeeded?, status }
Obtener estado completo de la tarea incluyendo subtareas, costos, decisiones y estado de aprobación.
Response: Objeto Task con subtasks, totalCost, pendingApprovals
Reanudar ejecución del pipeline tras aprobación del fundador. Se llama cuando se actualiza el status en approval_queue.
Body: { approvalId: string }
Response: { status, message }
Obtener salud por agente, costos diarios y tareas activas.
Response: Array de objetos de estado de agentes
Health check del servicio. Devuelve uptime y cantidad de tareas activas.
Response: { status: 'ok', uptime, activeTaskCount }
RATE LIMITS
Las solicitudes API tienen rate limit por organización.
- POST/PATCH: 10 solicitudes por minuto
- GET: 60 solicitudes por minuto
WEBHOOKS
Configura URLs de webhook por organización para revalidación y notificaciones tras publicar.
POST { path: '/blog', secret: REVALIDATION_SECRET } → revalidatePath(path)