> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List knowledge

> List the knowledge library of a workspace through the Nedzo REST API, with the agents that use each item.

<Note>
  This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](/api-reference/introduction#plan-access).
</Note>

List the knowledge items in a workspace, newest first. Each item shows the agents that use it. The text of a text item is not in the list. Get the item to read it.

<Tip>
  `workspaceId` is required for **account-scoped** API keys and taken from the key for **workspace-scoped** keys. See [Workspace ID and Request Scope](/authentication#workspace-id-and-request-scope).
</Tip>

## Query Parameters

<ParamField query="workspaceId" type="string" optional>
  The workspace. Required for an account-scoped key.
</ParamField>

<ParamField query="type" type="string" optional>
  Only items of this type: `website`, `text` or `file`.
</ParamField>

<ParamField query="limit" type="number" default="50">
  Items per page, from 1 to 100.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Items to skip, up to 100,000.
</ParamField>

## Response

<ResponseField name="items" type="array">
  The items on this page. Each has `id`, `workspaceId`, `name`, `type`, `websiteUrl`, `fileUrl`, `fileName`, `agents`, `createdAt` and `updatedAt`.
</ResponseField>

<ResponseField name="items[].agents" type="array">
  The agents that use the item. Each has `id`, `name` and `type` (`voice`, `chat` or `web`).
</ResponseField>

<ResponseField name="total" type="number">
  How many items match, across all pages.
</ResponseField>

<ResponseField name="hasMore" type="boolean">
  `true` when there is another page.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl "https://api.nedzo.ai/v1/knowledge?limit=50&offset=0" \
      -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response (200) theme={null}
  {
    "items": [
      {
        "id": "33333333-3333-4333-8333-333333333333",
        "workspaceId": "22222222-2222-4222-8222-222222222222",
        "name": "Pricing page",
        "type": "website",
        "websiteUrl": "https://example.com/pricing",
        "fileUrl": null,
        "fileName": null,
        "agents": [
          { "id": "44444444-4444-4444-8444-444444444444", "name": "Front desk", "type": "voice" }
        ],
        "createdAt": "2026-10-11T10:00:00Z",
        "updatedAt": "2026-10-11T10:00:00Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.