API REFERENCE

API pública de agentes

La API pública permite integrar un agente ya publicado sin acceder a endpoints internos de Studio. La URL base es https://api.inceptiva.com y todas las rutas estables pertenecen a /v1.

http

Authorization: Bearer <AGENT_API_KEY>
Content-Type: application/json

Método	Ruta	Uso
`GET`	`/v1/agents/{agent_id}`	Información y capacidades
`POST`	`/v1/agents/{agent_id}/responses`	Generación JSON
`POST`	`/v1/agents/{agent_id}/responses/stream`	Generación SSE
`GET`	`/v1/agents/{agent_id}/conversations/{conversation_id}/messages`	Historial paginado
`DELETE`	`/v1/agents/{agent_id}/conversations/{conversation_id}`	Eliminar conversación

agent_id es el identificador público del canal API. La API no permite crear o configurar agentes, Knowledge ni Tools y nunca expone retrieval_sources.

Compatibilidad

/v1 admite cambios aditivos. Un cambio incompatible requerirá una nueva versión de ruta. Las API keys son de servidor a servidor y no deben enviarse al navegador.