Docs
Open dashboard

Get knowledge document

GET/knowledge-base/{id}

Returns a single knowledge document with its full content and a signed download_url (when the document has an uploaded file). Not paywalled — reads are always available.

Requires Authorization: Bearer <api_key>. Create a key in the Inspra dashboard under Workspace Settings → API Keys.

Path parameters

  • idstringrequired
    UUID of the resource.

Response 200 OK

Knowledge document with content and download URL.

  • idstringuuidrequired
  • titlestring0–500 charsrequired
  • descriptionstringnullable0–2000 charsoptional
  • document_typestringrequired
    documentfaqproduct_infopolicyscriptother
  • statusstringrequired
    draftprocessingactivearchivederror
  • file_namestringnullableoptional
  • file_typestringnullableoptional
  • file_size_bytesintegernullableoptional
  • storage_pathstringnullableoptional
    Storage path returned from the upload-url endpoint.
  • tagsstring[]required
  • categorystringnullable0–255 charsoptional
  • usage_countintegerrequired
  • last_used_atstringnullabledate-timeoptional
  • created_atstringdate-timerequired
  • updated_atstringdate-timerequired
  • contentstringnullableoptional
    Text content of the document (only on single-document reads).
  • download_urlstringnullableoptional
    Signed download URL, valid for 5 minutes. Present only when the document has an uploaded file.

Errors

  • 401Unauthorized
    Missing, malformed, or invalid API key.
  • 403Forbidden
    Workspace unavailable, suspended, or paywalled.
  • 404Not Found
    Resource not found in this workspace.
  • 429Too Many Requests
    Workspace request limit exceeded; shared across all its API keys.