Create a knowledge base

​

Registers the HTTPS URL of your JSON data export and imports it right away. The response ready reports whether the first import succeeded; one that is not ready yet answers no calls until a later refresh succeeds.

Body·

required
application/json
  • refresh_url
    Type: string
    min length:  
    1    Format: uri
    required

    HTTPS URL of the structured JSON export this knowledge base reads. Resia fetches it when the knowledge base is created and again before each call that names it, with a conditional GET so an unchanged export is not downloaded twice. The response must carry an ETag header and a JSON object body.

Responses

  • application/json
  • application/json
Request Example for post/v1/knowledge-bases
curl /v1/knowledge-bases \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "refresh_url": ""
}'

{
  "id": "string",
  "refresh_url": "https://example.com",
  "ready": true,
  "last_source_version": "string",
  "created_at": "2026-09-24T21:09:12.160Z"
}

Successful Response