---
title: "List or search knowledge articles"
method: GET
path: "/v2/aether/playbook/knowledge"
tags: ["aether"]
---

# List or search knowledge articles

`GET /v2/aether/playbook/knowledge`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/aether/playbook/knowledge`
- Auth: HTTP bearer

Returns articles filtered by collection, customer, or segment. When
`query` is provided, performs a semantic search and returns the closest
matches.

## Query parameters

- `query` string, nullable: Search query; when set, performs semantic search
- `collection` union: Filter by a single collection or a list of collections
  - 'cash_application' | 'collections' | 'company' | 'credit_risk' | 'deductions' | 'disputes' | 'payments'
  - string[]
- `customer_id` string, nullable: Filter to a customer scope
- `segment_id` string, nullable: Filter to a segment scope
- `limit` integer, nullable: Max results when searching

## Response `200`

Successful Response

- Knowledge[]
  - `id` string, uuid, required: Article ID
  - `created_at` string, date-time, required: When this article was first created
  - `title` string, required: Article title
  - `description` string, nullable: What this article covers
  - `content` string, nullable: Full article content
  - `collection` string, required: Playbook collection
  - `knowledge_type` 'declarative' | 'document' | 'procedural', required
  - `status` 'archived' | 'published', required
  - `scope` 'shared' | 'segment' | 'customer', required
  - `customer_id` string, nullable: Customer this article is scoped to
  - `segment_id` string, nullable: Segment this article is scoped to
  - `published_at` string, date-time, nullable: When last published
  - `archived_at` string, date-time, nullable: When archived
  - `file_id` string, uuid, nullable: Reference document attachment
  - `file` StuutCoreAetherPlaybookTypesFile
    - `id` string, uuid, required: File ID
    - `name` string, required: File name
    - `mime_type` string, required: MIME type
    - `size` integer, nullable: File size in bytes
    - `presigned_url` string, required
  - `current_version` VersionSummary
    - `version_number` integer, required: Sequential version number
    - `author_id` string, nullable: User who authored this version
    - `operation` 'created' | 'modified', required
    - `created_at` string, date-time, required: When this version was created

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)