---
title: "Upsert Document Org"
method: PUT
path: "/api/v1/ai/organization/knowledge/documents"
tags: ["Knowledge"]
---

# Upsert Document Org

`PUT /api/v1/ai/organization/knowledge/documents`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/ai/organization/knowledge/documents`
- Auth: none declared

Upload or replace an org-scoped knowledge document.

## Request body `multipart/form-data`

- BodyUpsertOrgDocument
  - `file` string, binary, required
  - `scopes` string[]
  - `title` string

## Response `200`

Successful Response

- UploadDocumentResponse: Response for POST/PUT /documents.
  - `filename` string, required
  - `id` string, required
  - `message` string, required
  - `numChunks` integer, required
  - `success` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)