AI Bot API
Conversations and messages on a deployed bot, plus the admin surface for bot definitions, deploys and rollbacks.
For concepts and configuration see the block documentation.
Endpoints
Section titled “Endpoints”| Path |
|---|
/v1/bots/:bot/conversations |
/v1/bots/:bot/conversations/:id |
/v1/bots/:bot/conversations/:id/messages |
/v1/bots/:bot/conversations/:id/messages/stream |
Administration
Section titled “Administration”Separate surface, authenticated independently of the data plane.
| Path |
|---|
/admin/v1/bots |
/admin/v1/bots/:bot |
/admin/v1/bots/:bot/deploy |
/admin/v1/bots/:bot/rollback |
/admin/v1/health |
/admin/v1/stats |
Tenancy
Section titled “Tenancy”Every request carries the platform tenancy headers — X-Kis-Tenant, X-Kis-Product and
X-Kis-Environment. They are the partition key for storage, quotas and audit, so a request
without them is rejected rather than served against a default tenant.
Errors
Section titled “Errors”Errors use the platform’s structured error body: a stable code, a human-readable message, and the request id to correlate against logs and audit.