Repository navigation
Commit 5fc8a4c
Align Knowledge endpoints in 2.17 and Preview with API responses (#762)
* Align Knowledge endpoints in 2.17 and Preview with API responses
Correct the internal article, folder, content snippet, content search and
bulk action operations so the spec matches what the API returns.
- Add the OAuth scope line to the operations that lacked one
- Document the real error responses (401 token scope, 400 and 422
validation, 404 unknown teammate or folder, live-experiment conflict)
and fix examples whose codes or messages could not be produced
- Document page and per_page on list and search internal articles, the
optional admin_id on tag removal, and the locale and json_blocks
request fields
- Note that omitted keys (folder list fields, content search next and
prev) are absent rather than null
- Regenerate the internal article update and search examples with every
returned field, and drop the heading the markdown output never emits
- Add tags to the internal article list item (2.17) and widen the tag
schema description to cover internal articles and content snippets
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* Address review feedback on Knowledge endpoint docs
Narrow the tag applied_at/applied_by null case to content removals, say that
the detach admin_id is checked but not recorded, document the missing internal
article errors, add the content search 401 scope example, note values returned
as strings, and add request_id and per_page to a few examples.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>1 parent 1e83728 commit 5fc8a4c
2 files changed
Lines changed: 1413 additions & 175 deletions
0 commit comments