---
title: "Re-syncs every handout into the knowledge base (ITE-1480): mirrors a handout published before the sync existed, re-embeds one whose embedding failed, and drops the mirror of a deleted handout. Handout edits sync on their own; this is the catch-up."
method: POST
path: "/knowledge-documents/handouts/sync"
tags: ["TenantKnowledge"]
---

# Re-syncs every handout into the knowledge base (ITE-1480): mirrors a handout published before the sync existed, re-embeds one whose embedding failed, and drops the mirror of a deleted handout. Handout edits sync on their own; this is the catch-up.

`POST /knowledge-documents/handouts/sync`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/knowledge-documents/handouts/sync`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/knowledge-documents/handouts/sync/post.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

OK

- HandoutKnowledgeSyncResultDto: The result of re-syncing every handout into the Knowledge Base (ITE-1480).
  - `synced` union: Handouts whose mirror was brought up to date.
    - integer
    - string, int32
  - `removed` union: Mirrors removed because their handout no longer exists.
    - integer
    - string, int32

## Other responses

- `403`: Forbidden

## Changes

- **2026-10-28** `099cf36186e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/knowledge-documents/handouts/sync/post.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)