List Knowledge Sources

curl --request POST \
  --url https://api.velt.dev/v2/memory/knowledge/list \
  --header 'Content-Type: application/json' \
  --header 'x-velt-api-key: <x-velt-api-key>' \
  --header 'x-velt-auth-token: <x-velt-auth-token>' \
  --data '{
  "data": {}
}'

import requests

url = "https://api.velt.dev/v2/memory/knowledge/list"

payload = { "data": {} }
headers = {
    "x-velt-api-key": "<x-velt-api-key>",
    "x-velt-auth-token": "<x-velt-auth-token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-velt-api-key': '<x-velt-api-key>',
    'x-velt-auth-token': '<x-velt-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({data: {}})
};

fetch('https://api.velt.dev/v2/memory/knowledge/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velt.dev/v2/memory/knowledge/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-velt-api-key: <x-velt-api-key>",
    "x-velt-auth-token: <x-velt-auth-token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.velt.dev/v2/memory/knowledge/list"

	payload := strings.NewReader("{\n  \"data\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-velt-api-key", "<x-velt-api-key>")
	req.Header.Add("x-velt-auth-token", "<x-velt-auth-token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.velt.dev/v2/memory/knowledge/list")
  .header("x-velt-api-key", "<x-velt-api-key>")
  .header("x-velt-auth-token", "<x-velt-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.velt.dev/v2/memory/knowledge/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-velt-api-key"] = '<x-velt-api-key>'
request["x-velt-auth-token"] = '<x-velt-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "result": [
    {
      "id": "src_9a8...",
      "sourceType": "upload",
      "fileName": "brand-guidelines.pdf",
      "uploadedAt": 1748000000000,
      "mimeType": "application/pdf",
      "embeddingStatus": "completed",
      "originalDownloadUrl": "https://storage.googleapis.com/...",
      "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
    }
  ]
}

POST

memory

knowledge

list

List Knowledge Sources

curl --request POST \
  --url https://api.velt.dev/v2/memory/knowledge/list \
  --header 'Content-Type: application/json' \
  --header 'x-velt-api-key: <x-velt-api-key>' \
  --header 'x-velt-auth-token: <x-velt-auth-token>' \
  --data '{
  "data": {}
}'

import requests

url = "https://api.velt.dev/v2/memory/knowledge/list"

payload = { "data": {} }
headers = {
    "x-velt-api-key": "<x-velt-api-key>",
    "x-velt-auth-token": "<x-velt-auth-token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-velt-api-key': '<x-velt-api-key>',
    'x-velt-auth-token': '<x-velt-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({data: {}})
};

fetch('https://api.velt.dev/v2/memory/knowledge/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velt.dev/v2/memory/knowledge/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-velt-api-key: <x-velt-api-key>",
    "x-velt-auth-token: <x-velt-auth-token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.velt.dev/v2/memory/knowledge/list"

	payload := strings.NewReader("{\n  \"data\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-velt-api-key", "<x-velt-api-key>")
	req.Header.Add("x-velt-auth-token", "<x-velt-auth-token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.velt.dev/v2/memory/knowledge/list")
  .header("x-velt-api-key", "<x-velt-api-key>")
  .header("x-velt-auth-token", "<x-velt-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.velt.dev/v2/memory/knowledge/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-velt-api-key"] = '<x-velt-api-key>'
request["x-velt-auth-token"] = '<x-velt-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "result": [
    {
      "id": "src_9a8...",
      "sourceType": "upload",
      "fileName": "brand-guidelines.pdf",
      "uploadedAt": 1748000000000,
      "mimeType": "application/pdf",
      "embeddingStatus": "completed",
      "originalDownloadUrl": "https://storage.googleapis.com/...",
      "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
    }
  ]
}

Use this API to list your knowledge sources, each with its ingestion status and, for completed sources, signed download URLs. It returns the 100 most recently uploaded sources, newest first by uploadedAt. There is no pagination, so a workspace with more than 100 sources cannot reach the older ones through this API. 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

string

required

Your API key.

string

required

Your Auth Token.

Body

Params

object

required

No fields required. Send an empty object.

Example Requests

List all sources

{
  "data": {}
}

Response

Each item keeps the source’s persisted fields: sourceType, fileName, uploadedAt, ruleCount, chunkCount, and so on. On top of those, each item carries the source id, embeddingStatus (processing, completed, or failed), an optional mimeType (present for uploaded file sources), an optional failureReason, an optional dedupOf (the winning source id when this file deduped), an optional sha256, metadata.usedRawFallback when the pipeline fell back to raw text, and signed originalDownloadUrl/canonicalMdDownloadUrl for completed sources. The inline canonical markdown is omitted from the list; fetch it with Download Canonical Markdown. Both download URLs are 15-minute signed URLs, minted fresh on every request. Do not cache or store them; call this API again when you need a working URL. If a URL cannot be minted, the field is present with an empty string value.

Success Response

{
  "result": [
    {
      "id": "src_9a8...",
      "sourceType": "upload",
      "fileName": "brand-guidelines.pdf",
      "uploadedAt": 1748000000000,
      "mimeType": "application/pdf",
      "embeddingStatus": "completed",
      "originalDownloadUrl": "https://storage.googleapis.com/...",
      "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
    }
  ]
}

Failure Response

{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}

{
  "result": [
    {
      "id": "src_9a8...",
      "sourceType": "upload",
      "fileName": "brand-guidelines.pdf",
      "uploadedAt": 1748000000000,
      "mimeType": "application/pdf",
      "embeddingStatus": "completed",
      "originalDownloadUrl": "https://storage.googleapis.com/...",
      "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
    }
  ]
}

⌘I

REST APIs

SDK

List Knowledge Sources

Endpoint

Headers

Body

Params

Example Requests

List all sources

Response

Success Response

Failure Response

​Endpoint

​Headers

​Body

​Params

​Example Requests

​List all sources

​Response

​Success Response

​Failure Response

Endpoint

Headers

Body

Params

Example Requests

List all sources

Response

Success Response

Failure Response