Knowledge Hub REST APIs
Welcome to the Knowledge Hub REST API documentation.
Knowledge Hub provides two REST APIs. Use them to configure your knowledge and to search it from your applications and AI agents.
Management API
The Management API configures Knowledge Hub and creates ingestion jobs. Use it to manage the following resources:
- Repositories
- Knowledge bases
- Sources
- Schema mappings
- Ingestion jobs
The Knowledge Hub user interface and Data Integration both use this API.
Retrieve API
The Retrieve API searches your knowledge bases. Call it from agents and scripts to run semantic, lexical, or hybrid searches. For example, send a POST request to /api/v1/knowledge-bases/{knowledge_base_id}/retrieve.
Authentication
Every environment requires a Boomi Platform JWT. Send it in the Authorization header as a Bearer token. For more information, refer to Authenticating APIs.
Base URLs
Use the base URL for your environment. The Management API and Retrieve API use separate hosts.
| Environment | Management API | Retrieve API |
|---|---|---|
| Prod (US) | https://management-api.prod.kh.boomi.com | https://retrieve-api.prod.kh.boomi.com |
Rate limits
The Knowledge Hub APIs don't enforce request rate limits. Under heavy load, a request can take longer or return a temporary 503 Service Unavailable response. If this happens, retry the request after a short delay.