HydraCore
API by router

Knowledge

Ingest Text Admin

POST
/v1/knowledge/ingest

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Header Parameters

X-Api-Key?string|null

Request Body

application/json
  1. body
chunk_overlap?Chunk Overlap
Range0 <= value <= 1000
Default200
chunk_size?Chunk Size
Range200 <= value <= 5000
Default1500
content*Content

Text content to ingest

Length1 <= length
customer_id?|null
instance_id?|null
source_id*Source Id

Source identifier (file path, URL, etc.)

Lengthlength <= 500
source_name*Source Name

Human-readable source name

Lengthlength <= 500
source_type?Source Type

Source type: r2, drive, web, sheet, email

Default"r2"

Response Body

Successful Response

application/json
  1. response
chunks_created*Chunks Created
source_id*Source Id
tokens_embedded*Tokens Embedded
Example Request
curl -X POST 'https://example.com/v1/knowledge/ingest' \  -H 'Content-Type: application/json' \  -d '{  "content": "string",  "source_id": "string",  "source_name": "string"}'
Example Response
{  "chunks_created": 0,  "source_id": "string",  "tokens_embedded": 0}

List Sources

GET
/v1/knowledge/sources

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Query Parameters

customer_id?|null

Header Parameters

X-Api-Key?string|null

Response Body

Successful Response

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://example.com/v1/knowledge/sources'
Example Response
[  {    "chunk_count": 0,    "source_id": "string",    "source_name": "string",    "source_type": "string",    "total_tokens": 0  }]

Delete Source

DELETE
/v1/knowledge/sources/{source_id}

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

source_id*Source Id

Query Parameters

source_type?Source Type
Default"r2"
customer_id?|null
instance_id?|null

Header Parameters

X-Api-Key?string|null

Response Body

Successful Response

application/json
  1. response
Example Request
curl -X DELETE 'https://example.com/v1/knowledge/sources/string'
Example Response
{}