---
title: "Update a knowledge article"
method: PATCH
path: "/v2/aether/playbook/knowledge/{article_id}"
tags: ["aether"]
---

# Update a knowledge article

`PATCH /v2/aether/playbook/knowledge/{article_id}`

## 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/{article_id}`
- Auth: HTTP bearer

Providing `content` creates a new revision (optionally with an updated
title or description); `collection` alone moves the article. Title or
description changes require `content` to be sent as well.

## Path parameters

- `article_id` string, required

## Request body

- UpdateKnowledgeInput
  - `content` string: New article content (full replacement, not a diff)
  - `title` string: New title
  - `description` string: New description
  - `collection` 'cash_application' | 'collections' | 'company' | 'credit_risk' | 'deductions' | 'disputes' | 'payments': New collection

## 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)