# Orq.ai Knowledge Bases API

**Canonical:** https://apis.io/apis/orq/orq-knowledge-bases-api/  
**Provider:** Orq.ai — https://apis.io/providers/orq/  
**Base URL:** https://my.orq.ai  
**Documentation:** https://docs.orq.ai/reference

Orq.ai Knowledge Bases API is one of 59 APIs that [Orq.ai](https://apis.io/providers/orq/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Knowledge Bases. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Create and manage knowledge bases used by agents and retrieval workflows.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/knowledge` | List all knowledge bases |
| POST | `/v2/knowledge` | Create a knowledge base |
| GET | `/v2/knowledge/{knowledge_id}` | Retrieve a knowledge base |
| DELETE | `/v2/knowledge/{knowledge_id}` | Delete a knowledge base |
| PATCH | `/v2/knowledge/{knowledge_id}` | Update a knowledge base |
| GET | `/v2/knowledge/{knowledge_id}/datasources` | List all datasources |
| POST | `/v2/knowledge/{knowledge_id}/datasources` | Create a new datasource |
| POST | `/v2/knowledge/{knowledge_id}/datasources/preview-chunks` | Preview datasource chunks |
| GET | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}` | Retrieve a datasource |
| DELETE | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}` | Delete a datasource |
| PATCH | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}` | Update a datasource |
| GET | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks` | List all chunks for a datasource |
| POST | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks` | Create chunks for a datasource |
| DELETE | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks` | Delete multiple chunks |
| POST | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/count` | Get chunks total count |
| POST | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/list` | List chunks with offset-based pagination |
| GET | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/{chunk_id}` | Retrieve a chunk |
| DELETE | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/{chunk_id}` | Delete a chunk |
| PATCH | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/{chunk_id}` | Update a chunk |
| PATCH | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/{chunk_id}/enabled` | Set a chunk's enabled status |
| GET | `/v2/knowledge/{knowledge_id}/datasources/{datasource_id}/datasource-processing-status` | Retrieve datasource processing status |
| POST | `/v2/knowledge/{knowledge_id}/search` | Search knowledge base |
| GET | `/v2/knowledge/{knowledge_id}/upload-file` | Retrieve a file upload URL |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/orq/openapi/orq-knowledge-bases-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-invoke-deployment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-search-knowledge-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-response-stream-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-agent-thought-streaming-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-agent-started-streaming-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-model-metadata-schema.json

## Other Orq.ai APIs (12)

- [Orq.ai Agent Feedback API](https://apis.io/apis/orq/orq-agent-feedback-api/)
- [Orq.ai Agent Schedules API](https://apis.io/apis/orq/orq-agent-schedules-api/)
- [Orq.ai Agents API](https://apis.io/apis/orq/orq-agents-api/)
- [Orq.ai Alerts API](https://apis.io/apis/orq/orq-alerts-api/)
- [Orq.ai Annotation Queues API](https://apis.io/apis/orq/orq-annotation-queues-api/)
- [Orq.ai Annotations API](https://apis.io/apis/orq/orq-annotations-api/)
- [Orq.ai API keys API](https://apis.io/apis/orq/orq-api-keys-api/)
- [Orq.ai Audio API](https://apis.io/apis/orq/orq-audio-api/)
- [Orq.ai Audit Logs API](https://apis.io/apis/orq/orq-audit-logs-api/)
- [Orq.ai Budgets API](https://apis.io/apis/orq/orq-budgets-api/)
- [Orq.ai Chunking API](https://apis.io/apis/orq/orq-chunking-api/)
- [Orq.ai Classify API](https://apis.io/apis/orq/orq-classify-api/)

## Tags

Knowledge Bases

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/orq/orq-knowledge-bases-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/orq/.