Version: 1.0.0
Koia Platform API - Public Endpoints
Koia Platform API - Public endpoints for AI agent inference.
This API provides public access to AI agent inference capabilities without requiring user authentication. Use your agent's access token for authorization.
Authentication
Use the agent's access token in the Authorization header as Bearer token.
Session Management
- For the first message, do not include
sessionIdin the request - The response will include a
sessionIdthat should be used in subsequent messages to maintain conversation context - Include the
sessionIdin all follow-up messages to continue the same conversation
Error Handling
The API uses consistent error responses:
- 400: Validation errors
- 401: Authentication/authorization errors
- 404: Agent not found
- 500: Internal server errors
Authentication
- HTTP: Bearer Auth
Agent access token
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |