List knowledge documents

The brand’s knowledge base: the documents Asky grounds content generation and alignment claims in (uploaded PDFs and pasted text). One row per document with title, the user’s description, source_type, processing status, size (char_count), and updated_at — metadata only, never the document text. Fetch Get knowledge document for the full content of one.

Style documents (attached to a writing style rather than general brand knowledge) are excluded by default. Pass writing_style_id to see one style’s documents instead.

Requires the read:knowledge_base scope.


GET /v1/brands/{brand_id}/knowledge-documents

Authorization

Header	Type	Required
`Authorization`	`Bearer asky_sk_…`	required

Path parameters

Parameter	Type	Required	Description
`brand_id`	`uuid`	required	From List brands

Query parameters

Parameter	Type	Required	Description
`limit`	`integer`	optional	Rows per page, 1 to 100. Defaults to 20.
`cursor`	`string`	optional	Opaque cursor from the previous response. Treat it as a token, never construct one.
`writing_style_id`	`uuid`	optional	Show this style’s documents instead of general brand knowledge.

Request

cURL


curl --request GET \
  --url 'https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/knowledge-documents?limit=50' \
  --header 'Authorization: Bearer <api-key>'

Python


import requests
 
url = "https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/knowledge-documents?limit=50"
 
headers = {"Authorization": "Bearer <api-key>"}
 
response = requests.get(url, headers=headers)
print(response.text)

JavaScript


const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <api-key>'}
};
 
fetch('https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/knowledge-documents?limit=50', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

PHP


<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/knowledge-documents?limit=50",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <api-key>"
  ],
]);
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Go


package main
 
import (
    "fmt"
    "net/http"
    "io"
)
 
func main() {
 
    url := "https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/knowledge-documents?limit=50"
 
    req, _ := http.NewRequest("GET", url, nil)
 
    req.Header.Add("Authorization", "Bearer <api-key>")
 
    res, _ := http.DefaultClient.Do(req)
 
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
 
    fmt.Println(string(body))
 
}

Ruby


require 'uri'
require 'net/http'
 
url = URI("https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/knowledge-documents?limit=50")
 
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
 
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <api-key>'
 
response = http.request(request)
puts response.read_body

Response

200


{
  "data": [
    {
      "id": "b4f7e2a1-9c3d-4e6f-8a1b-2c5d7e9f0a3b",
      "title": "Product Positioning FAQ",
      "user_description": "Internal FAQ used to ground content about our differentiation.",
      "source_type": "paste",
      "status": "ready",
      "char_count": 4820,
      "updated_at": "2026-08-20T09:14:22.000Z"
    },
    {
      "id": "d29a6f31-1c4e-4b8a-9d2f-7a0c3e5b8f61",
      "title": "2026 Product Spec Sheet",
      "user_description": null,
      "source_type": "pdf",
      "status": "ready",
      "char_count": 12040,
      "updated_at": "2026-08-27T16:03:11.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "request_id": "req_2f7b90c14ae8471da3cd"
}

401


{
  "error": {
    "code": "token_expired",
    "message": "This API key has expired. Roll it from the API tab on the Connections page to get a replacement.",
    "request_id": "req_8f21c0aa47b1490d2e63"
  }
}

404


{
  "error": {
    "code": "not_found",
    "message": "Not found.",
    "request_id": "req_5b0e77d213a94f6a8ce1"
  }
}

429


{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after 24 seconds.",
    "request_id": "req_31c9ba7f0e5d4a118cc2"
  }
}

Response fields

Field	Type	Description
`data[].id`	`uuid`	required. Use it as `document_id` on Get knowledge document and Get knowledge document file
`data[].title`	`string`	required
`data[].user_description`	`string \| null`	required
`data[].source_type`	`string`	required. One of `paste`, `pdf`, `mcp` — `mcp` is a legacy value, see Notes
`data[].status`	`string`	required. One of `processing`, `ready`, `failed`
`data[].char_count`	`integer`	required
`data[].updated_at`	`timestamptz`	required
`request_id`	`string`	required. Also returned as the `x-request-id` header. Quote it when contacting support

Errors

Status	Code	When
400	`invalid_request`	A parameter is unknown or malformed. The message names it
401	`invalid_token`	The key is missing, malformed, or does not exist
401	`token_expired`	The key passed its expiry date
401	`token_revoked`	The key was revoked
403	`insufficient_scope`	The key does not carry `read:knowledge_base`
404	`not_found`	The brand does not exist, or this key is not allowed to reach it
429	`rate_limited`	Over 300 requests per minute

Notes

Style documents are excluded unless you ask for them. Omit writing_style_id to see the brand’s general knowledge base; pass it to see one writing style’s own document set instead. A document belongs to one or the other, never both.

This is metadata only. There is no raw_text or body_html here — fetch Get knowledge document for the full content of a specific row.

Bounded, not deeply paginated. limit and cursor work as they do elsewhere, but this endpoint never returns more than 200 documents total across all pages, regardless of how many the brand has. In practice a brand’s knowledge base is bounded by its 50MB workspace storage cap long before row count becomes the limiting factor, but the query itself still hard-caps at 200 rows.

source_type: "mcp" is legacy. It marks a document imported through the app’s now-removed “from-app” import path. This API never creates one, but an existing document imported that way can still show it.