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

# List Knowledge Sources

> List your Velt Memory v2 knowledge sources, each with ingestion status, embedding state, and signed download URLs for completed files.

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>