curl --request GET \
--url https://core-api.getaptly.com/api/knowledge/list \
--header 'x-token: <api-key>'import requests
url = "https://core-api.getaptly.com/api/knowledge/list"
headers = {"x-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-token': '<api-key>'}};
fetch('https://core-api.getaptly.com/api/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://core-api.getaptly.com/api/knowledge/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://core-api.getaptly.com/api/knowledge/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://core-api.getaptly.com/api/knowledge/list")
.header("x-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core-api.getaptly.com/api/knowledge/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"docs": [
{
"_id": "<string>",
"name": "<string>",
"emoji": "<string>",
"iconUrl": "<string>",
"accessType": "public",
"parentId": "<string>",
"rank": 123,
"archived": true
}
],
"total": 123,
"limit": 123,
"skip": 123
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}List knowledge documents
Lists knowledge documents scoped to your company — a folder’s contents, or everything linked to a board, card, or conversation — in a lite shape (no rendered HTML), paginated.
Access is scoped per-user when authenticated with a delegate token; API keys and partner tokens see every document in the company regardless of its private-doc shares.
curl --request GET \
--url https://core-api.getaptly.com/api/knowledge/list \
--header 'x-token: <api-key>'import requests
url = "https://core-api.getaptly.com/api/knowledge/list"
headers = {"x-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-token': '<api-key>'}};
fetch('https://core-api.getaptly.com/api/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://core-api.getaptly.com/api/knowledge/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://core-api.getaptly.com/api/knowledge/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://core-api.getaptly.com/api/knowledge/list")
.header("x-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core-api.getaptly.com/api/knowledge/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"docs": [
{
"_id": "<string>",
"name": "<string>",
"emoji": "<string>",
"iconUrl": "<string>",
"accessType": "public",
"parentId": "<string>",
"rank": 123,
"archived": true
}
],
"total": 123,
"limit": 123,
"skip": 123
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Query Parameters
Omit to list every document regardless of nesting. Pass "" or "null" to list root documents only, or a document ID to list that folder's contents.
Only documents associated with this board.
Only documents linked to this card.
Only documents extracted from this conversation.
Case-insensitive substring match on document name. Regex metacharacters are escaped before being interpolated into the query, so the match is always literal.
Set true to list archived documents instead of active ones.
Only documents created by this user (matches createdBy).
Only documents last updated by this user (matches updatedBy).
Only documents created on or after this ISO date (inclusive).
Only documents created on or before this ISO date (inclusive).
Only documents last updated on or after this ISO date (inclusive). Filters updatedAt only, never createdAt.
Only documents last updated on or before this ISO date (inclusive). Filters updatedAt only, never createdAt.
Set true to list only documents with no aptletUuid, aptletInstanceId, or streamId — the knowledge base's own top-level documents ("pane 0"), as opposed to documents that hang off a board, card, or conversation. Cannot be combined with aptletUuid, aptletInstanceId, or streamId.
A non-numeric value is rejected with 400 rather than silently defaulting. A valid non-integer value (e.g. 10.5) is truncated.
x <= 200A non-numeric or negative value is rejected with 400 rather than silently coercing to 0. A valid non-integer value is truncated.
x >= 0