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

# List Knowledge Sources

Use this API to list your knowledge sources (capped at 100), each with its ingestion status and, for completed sources, signed download URLs. For a de-duplicated source (`dedupOf` set), `embeddingStatus` and the download URLs mirror the winning source's state, matching Get Ingest Status.

# Endpoint

`POST https://api.velt.dev/v2/memory/knowledge/list`

# Headers

<ParamField header="x-velt-api-key" type="string" required>
  Your API key.
</ParamField>

<ParamField header="x-velt-auth-token" type="string" required>
  Your [Auth Token](/security/auth-tokens).
</ParamField>

# Body

#### Params

<ParamField body="data" type="object" required>
  No fields required. Send an empty object.
</ParamField>

## **Example Requests**

#### List all sources

```JSON theme={null}
{
  "data": {}
}
```

# Response

Each item includes the source `id`, `mimeType`, `embeddingStatus` (`processing`, `completed`, or `failed`), an optional `failureReason`, an optional `dedupOf` (the winning source id when this file deduped), and signed `originalDownloadUrl`/`canonicalMdDownloadUrl` for completed sources.

#### Success Response

```JSON theme={null}
{
  "result": [
    {
      "id": "src_9a8...",
      "mimeType": "application/pdf",
      "embeddingStatus": "completed",
      "originalDownloadUrl": "https://storage.googleapis.com/...",
      "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
    }
  ]
}
```

#### Failure Response

```JSON theme={null}
{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}
```

<ResponseExample>
  ```js theme={null}
  {
    "result": [
      {
        "id": "src_9a8...",
        "mimeType": "application/pdf",
        "embeddingStatus": "completed",
        "originalDownloadUrl": "https://storage.googleapis.com/...",
        "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
      }
    ]
  }
  ```
</ResponseExample>