---
title: "Create knowledge file"
method: POST
path: "/workspaces/{workspaceID}/knowledges"
tags: ["Knowledge"]
---

# Create knowledge file

`POST /workspaces/{workspaceID}/knowledges`

## Request

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

Create a knowledge record from a previously uploaded temporary file. Upload the file with POST /knowledges/files first.

## Path parameters

- `workspaceID` string, required

## Request body

- union
  - object
  - ApiCreateKnowledgeRequest
    - `filename` string, required

## Response `200`

Created knowledge file

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

## Other responses

- `400`: Bad Request
- `409`: Knowledge file already exists
- `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)