API REFERENCE

Public agent API

The base URL is https://api.inceptiva.com. Stable routes live under /v1 and use server-side bearer authentication.

http

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

Method	Path	Purpose
`GET`	`/v1/agents/{agent_id}`	Public agent and capabilities
`POST`	`/v1/agents/{agent_id}/responses`	JSON generation
`POST`	`/v1/agents/{agent_id}/responses/stream`	SSE generation
`GET`	`/v1/agents/{agent_id}/conversations/{conversation_id}/messages`	Paginated history
`DELETE`	`/v1/agents/{agent_id}/conversations/{conversation_id}`	Delete a conversation

agent_id identifies the public API channel. The API cannot administer agents, Knowledge, or Tools and never exposes retrieval_sources. /v1 permits additive changes; incompatible changes require a new path version.