Skip to main content
POST
/
v1
/
orgs
/
{org_id}
/
knowledge
/
documents
Upload Knowledge Documents
curl --request POST \
  --url https://api.letpiper.com/v1/orgs/{org_id}/knowledge/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form collectionId=3c90c3cc-0d44-4b50-8888-8dd25736052a \
  --form 'files=<string>' \
  --form 'language=<string>' \
  --form files.items='@example-file'
{
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "collectionId": "<string>",
  "totalFiles": 123,
  "successes": 123,
  "failures": 123,
  "results": [
    {
      "filename": "<string>",
      "mimeType": "<string>",
      "bytesIngested": 123,
      "status": "pending",
      "documentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "error": "<string>",
      "relativePath": "<string>",
      "isDuplicate": false,
      "existingDocumentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "language": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Platform token (starts with pat_)

Path Parameters

org_id
string<uuid>
required

Body

multipart/form-data
collectionId
string<uuid>
required
files
file[]
required
language
string | null

Language code (e.g., 'en', 'es', 'fr')

Response

Successful Response

Response returned after a batch upload request.

requestId
string<uuid>
required
collectionId
string
required
totalFiles
integer
required
successes
integer
required
failures
integer
required
results
UploadedFileResult · object[]
required