Call the Inkeep RAG API with an HTTP Request
The Inkeep RAG API provides structured documents from your knowledge base. This page shows how to make direct HTTP requests to the API. Please ensure you have an API key (don't have one? Get one here).
Request Format
Response Format
Content Example
The sources are under content
as stringified JSON. The parsed result looks like:
Content Schema
The RAG API returns a JSON object with an array of documents in the content
field. Each document has the following structure:
Field | Type | Description |
---|---|---|
type | string | The type of the document, typically "document" |
record_type | string | The source of the document (e.g., "Documentation", "GitHub Issue", "Forum") |
url | string | The URL where the document can be found |
title | string | The title of the document |
source | object | Contains the content of the document (see Source Entity for details) |
context | string | Optional additional context about the document |
Source Entity
The source
field contains the actual content of the document in a structured format. It has the following structure:
Field | Type | Description |
---|---|---|
type | string | Type of the source, typically "content" |
content | array | Array of content blocks |
Each item in the content
array has the following structure:
Field | Type | Description |
---|---|---|
type | string | Type of content block (e.g., "text") |
text | string | The actual text content when type is "text" |
media_type | string | Optional media type of the content (e.g., "text/plain") |
data | string | Optional alternative data field for content |
Document Source Types
The RAG API can return documents from various sources:
Record Type | Description |
---|---|
documentation | Official documentation pages |
site | Content from your website |
discourse_post | Discourse Forum Posts |
github_issue | GitHub issues or pull requests |
github_discussion | GitHub Discussions |
stackoverflow_question | StackOverflow Questions and Answers |
discord_forum_post | Discord Forum Posts |
discord_message | Discord Threads/Messages |
custom_question_answer | Custom FAQ Added to the knowledge base |
Example Usage
Here's an example of how to call the RAG API using curl:
Example Source Entity
Here's an example of a source entity from the response:
Processing the Response
To process the response, you'll need to:
- Parse the JSON response
- Extract the
content
field from themessage.content
JSON string - Process each document in the
content
array
This will give you structured access to the documents retrieved from your knowledge base.