Skip to content

Knowledge bases

Create, list, rename and delete bases — the container for your documents.

Updated on Aug 10, 2026

The base is the container: documents, Q&A and searches always happen within one. The id returned on creation is the rag_id used in all other calls. The base is created within the scope of the key — organization and project come from the API key, not from the request body.

POSThttps://api.hinow.ai/v1/rag/ragsBearer

Creates a knowledge base.

Parâmetros

  • namestring· bodyobrigatório
  • descriptionstring· body

    Optional.

Respostas

200Base created
{
  "id": "1d9cf4ae05f64a9faf987981b22cdeae",
  "name": "Central de ajuda",
  "description": "FAQ e políticas",
  "organization_id": "1e45f818-...",
  "project_id": "f4be996e-...",
  "created_at": "2026-08-10T21:22:41Z",
  "updated_at": "2026-08-10T21:22:41Z"
}
GEThttps://api.hinow.ai/v1/rag/ragsBearer

Lists the bases in the key's scope.

Respostas

200List of bases
{
  "rags": [
    { "id": "1d9cf4ae...", "name": "Central de ajuda", ... }
  ]
}
GEThttps://api.hinow.ai/v1/rag/rags/{id}Bearer

Retrieves a base by id.

Parâmetros

  • idstring· pathobrigatório

Respostas

200The base
404Non-existent base (or from another scope)
PUThttps://api.hinow.ai/v1/rag/rags/{id}Bearer

Renames the base or changes the description.

Parâmetros

  • idstring· pathobrigatório
  • namestring· body
  • descriptionstring· body

Respostas

200Base updated
DELETEhttps://api.hinow.ai/v1/rag/rags/{id}Bearer

Deletes the base. All documents go to trash and can be restored for 15 days.

Parâmetros

  • idstring· pathobrigatório

Respostas

200Base removed
{
  "rag_id": "1d9cf4ae...",
  "deleted": true,
  "trashed_documents": 7
}

Bases "vs_..." in the listing

Vector stores created by the Assistants API (file search) live in the same registry and appear in the listing with id vs_.... You can search them here normally; to manage them, prefer the vector stores endpoints from the Assistants API.

Was this page helpful?