---
title: "Replace one permanently unreadable private source document"
method: POST
path: "/v1/knowledge-documents/{document_id}/replace"
---

# Replace one permanently unreadable private source document

`POST /v1/knowledge-documents/{document_id}/replace`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/knowledge-documents/{document_id}/replace`
- Auth: none declared

Send raw replacement bytes with X-Skysay-Filename and tenant-bound organization_id/project_id query parameters. The replacement is stored and queued before the unreadable source is scheduled for deletion; this endpoint is unavailable for searchable or retryable documents.

## Path parameters

- `document_id` string, required

## Query parameters

- `organization_id` string: Optional compatibility echo; the bearer workspace is authoritative.
- `project_id` string, required

## Response `201`

Replacement queued and unreadable source scheduled for deletion

---

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