MCP is live.Set upAsk the community
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCP
Knowledge base

List knowledge base files

List all knowledge-base files for the authenticated user.

GET/knowledge_base/list
Query parameters
user_idinteger

Reseller keys only: act as one of your clients by its user id. Omit it to act on your own account. [How acting for a client works](/docs/reseller/your-clients/acting-as-clients). 

curl -X GET 'https://omnidim.io/api/v1/knowledge_base/list' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example response
{
  "success": true,
  "files": [
    {
      "id": 964,
      "name": "customer_call.mp3",
      "original_filename": "customer_call.mp3",
      "file_size": 1145133,
      "mime_type": "audio/mpeg",
      "download_url": "https://omnidim.s3.amazonaws.com/live_uploads/1234/20260411_162353_customer_call.mp3?AWSAccessKeyId=AKIA...&Signature=...&Expires=...",
      "upload_status": "uploaded",
      "upload_date": "04/11/2026 16:24:00",
      "user_name": "Demo User",
      "user_id": 1234,
      "organization_id": 14
    }
  ]
}

Authorization

BearerAuth
headerAuthorizationBearer <token>

Bearer token authentication. Obtain your API key from the OmniDimension dashboard.

Query Parameters

user_id?integer

Reseller keys only: act as one of your clients by its user id. Omit it to act on your own account. How acting for a client works.

Response body

application/json

Response Body

List of files.

application/json
success?boolean
files?

Was this page helpful?

Restore an agent version

Restore a version onto the live agent. Your current setup is saved first as a backup version, so restoring is undoable. Configuration is brought back; any knowledge files or integrations that were deleted since this version was saved can't be re-linked, and are reported in `skipped`.

Check file upload capability

Check whether a file can be uploaded based on size and type.