List the documents in a collection

GET

knowledge

documents

curl --request GET "$MITHUNAI_URL/arukz/api/v1/knowledge/documents?collection_id=0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88&limit=2&offset=0" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/knowledge/documents",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    params={
        "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
        "limit": 2,
        "offset": 0,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const params = new URLSearchParams({
  collection_id: '0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88',
  limit: '2',
  offset: '0',
})
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/knowledge/documents?${params}`,
  {
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  },
)
console.log(await response.json())

{
  "data": [
    {
      "id": "7e2d4b1a-9c3f-5a86-b1e4-0d6c8f2a3b57",
      "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
      "source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
      "title": "Rate limits",
      "path": "docs/api/rate-limits.md",
      "content_type": "markdown",
      "status": "active",
      "source_url": "https://github.com/example-org/platform-docs/blob/4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e/docs/api/rate-limits.md",
      "source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
      "first_seen_at": "2026-09-24T10:21:13.550182",
      "last_seen_at": "2026-09-24T10:21:13.550182"
    },
    {
      "id": "1c8f3e6d-2a7b-5d90-8e14-b3f60a9c7d25",
      "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
      "source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
      "title": "Authentication",
      "path": "docs/api/authentication.md",
      "content_type": "markdown",
      "status": "active",
      "source_url": "https://github.com/example-org/platform-docs/blob/4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e/docs/api/authentication.md",
      "source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
      "first_seen_at": "2026-09-24T10:21:09.204771",
      "last_seen_at": "2026-09-24T10:21:09.204771"
    }
  ],
  "total": 198,
  "limit": 2,
  "offset": 0,
  "has_more": true
}

{ "code": "validation_error", "message": "'collection_id' is required." }

{ "code": "not_found", "message": "The knowledge collection was not found." }

Returns document metadata only. No endpoint returns a document’s text. collection_id is required. Leaving it out returns 400 rather than an unfiltered list, and a collection that is not in your organization returns 404. Documents are ordered by when they were first seen, newest first. Page through the results with limit and offset. See Pagination. limit and offset are clamped rather than refused. A limit below 1 becomes 1, a limit above 100 becomes 100, and a negative offset becomes 0. A value that is not a whole number returns 400. Any role in the organization can list documents.

string

required

Collection ID (a UUID). A malformed value returns 400.

string

Return only documents produced by this source. An ID that matches none of the collection’s sources returns an empty page.

boolean

default:"false"

Include documents that have disappeared from their source (status deleted). Only true, 1 or yes turn it on. Any other value counts as false.

integer

default:"50"

Page size, from 1 to 100.

integer

default:"0"

Number of documents to skip.

Response

object[]

required

The page of documents.

Show properties

string

required

Document ID (a UUID). It stays the same across syncs for the same path in the same source.

string

required

Collection the document belongs to.

string

required

Source that produced the document.

string

required

Document title.

string

required

The document’s path within its source, such as a repository path or an uploaded filename.

string

required

markdown, plain_text, restructured_text, source_code, html, pdf or docx.

string

required

active, or deleted when the document is no longer in its source. Deleted documents are not used in answers.

string | null

required

A link to the document at its source, when the source has one.

string

required

The source version the stored content was read at, such as a commit SHA.

string | null

required

ISO 8601 timestamp, in UTC, of the first sync that found the document.

string | null

required

ISO 8601 timestamp, in UTC, of the latest sync that found the document.

integer

required

Number of documents matching the filters, across all pages.

integer

required

The page size applied, after clamping.

integer

required

The offset applied, after clamping.

boolean

required

true when more documents follow this page.

curl --request GET "$MITHUNAI_URL/arukz/api/v1/knowledge/documents?collection_id=0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88&limit=2&offset=0" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/knowledge/documents",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    params={
        "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
        "limit": 2,
        "offset": 0,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const params = new URLSearchParams({
  collection_id: '0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88',
  limit: '2',
  offset: '0',
})
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/knowledge/documents?${params}`,
  {
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  },
)
console.log(await response.json())

{
  "data": [
    {
      "id": "7e2d4b1a-9c3f-5a86-b1e4-0d6c8f2a3b57",
      "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
      "source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
      "title": "Rate limits",
      "path": "docs/api/rate-limits.md",
      "content_type": "markdown",
      "status": "active",
      "source_url": "https://github.com/example-org/platform-docs/blob/4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e/docs/api/rate-limits.md",
      "source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
      "first_seen_at": "2026-09-24T10:21:13.550182",
      "last_seen_at": "2026-09-24T10:21:13.550182"
    },
    {
      "id": "1c8f3e6d-2a7b-5d90-8e14-b3f60a9c7d25",
      "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
      "source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
      "title": "Authentication",
      "path": "docs/api/authentication.md",
      "content_type": "markdown",
      "status": "active",
      "source_url": "https://github.com/example-org/platform-docs/blob/4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e/docs/api/authentication.md",
      "source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
      "first_seen_at": "2026-09-24T10:21:09.204771",
      "last_seen_at": "2026-09-24T10:21:09.204771"
    }
  ],
  "total": 198,
  "limit": 2,
  "offset": 0,
  "has_more": true
}

{ "code": "validation_error", "message": "'collection_id' is required." }

{ "code": "not_found", "message": "The knowledge collection was not found." }

Last modified on September 26, 2026

⌘I

curl --request GET "$MITHUNAI_URL/arukz/api/v1/knowledge/documents?collection_id=0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88&limit=2&offset=0" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/knowledge/documents",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    params={
        "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
        "limit": 2,
        "offset": 0,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const params = new URLSearchParams({
  collection_id: '0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88',
  limit: '2',
  offset: '0',
})
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/knowledge/documents?${params}`,
  {
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  },
)
console.log(await response.json())

{
  "data": [
    {
      "id": "7e2d4b1a-9c3f-5a86-b1e4-0d6c8f2a3b57",
      "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
      "source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
      "title": "Rate limits",
      "path": "docs/api/rate-limits.md",
      "content_type": "markdown",
      "status": "active",
      "source_url": "https://github.com/example-org/platform-docs/blob/4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e/docs/api/rate-limits.md",
      "source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
      "first_seen_at": "2026-09-24T10:21:13.550182",
      "last_seen_at": "2026-09-24T10:21:13.550182"
    },
    {
      "id": "1c8f3e6d-2a7b-5d90-8e14-b3f60a9c7d25",
      "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
      "source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
      "title": "Authentication",
      "path": "docs/api/authentication.md",
      "content_type": "markdown",
      "status": "active",
      "source_url": "https://github.com/example-org/platform-docs/blob/4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e/docs/api/authentication.md",
      "source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
      "first_seen_at": "2026-09-24T10:21:09.204771",
      "last_seen_at": "2026-09-24T10:21:09.204771"
    }
  ],
  "total": 198,
  "limit": 2,
  "offset": 0,
  "has_more": true
}

{ "code": "validation_error", "message": "'collection_id' is required." }

{ "code": "not_found", "message": "The knowledge collection was not found." }

Get started

Conversations

Assistants

Models

Knowledge

Widget deployments

Widget (public)

MCP

API keys

Members

Analytics

Support access

Branding

Operations

List the documents in a collection

Response

​Response

Response