---
title: "Replace knowledge file"
method: PUT
path: "/workspaces/{workspaceID}/knowledges/{knowledgeID}/file"
tags: ["Knowledge"]
---

# Replace knowledge file

`PUT /workspaces/{workspaceID}/knowledges/{knowledgeID}/file`

## Request

- Base URL: `https://api.salesforge.ai/public/v2`
- URL: `https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/knowledges/{knowledgeID}/file`
- Auth: API key in header `Authorization`

Replace an existing knowledge base file. The uploaded filename may rename the file.

## Path parameters

- `workspaceID` string, required
- `knowledgeID` string, required

## Request body `application/x-www-form-urlencoded`

- unknown

## Response `200`

Updated knowledge file

- ApiKnowledgeResponse
  - `contentType` string
  - `embeddingStatus` string
  - `filename` string
  - `id` string
  - `size` integer
  - `tags` string[]
  - `workspaceId` string

## Other responses

- `400`: Bad Request
- `404`: Knowledge file not found
- `409`: Knowledge filename already exists
- `413`: File exceeds 5MB limit
- `500`: Internal Server Error

---

[API](https://skmtc.dev/salesforge/apis/salesforge-api.md) - [All operations](https://skmtc.dev/salesforge/apis/salesforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/salesforge/apis/salesforge-api/revisions/3f946278b378?raw)