Skip to main content
POST
Upload document
Upload a UTF-8 text file into a knowledge base. This is a multipart request, not JSON. Form fields:
  • name (required)
  • description (optional, 2000 characters or fewer)
  • file (required, maximum 130 KB)
The document is created with status: "pending" while Akapulu Labs chunks and embeds it (usually about 15–20 seconds). Poll list documents until status is completed. Example:

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

corpus_id
string<uuid>
required

Knowledge base ID.

Body

multipart/form-data
name
string
required
Maximum string length: 255
file
file
required

UTF-8 text file. Maximum 130 KB.

description
string
Maximum string length: 2000

Response

Document accepted for embedding

status
enum<string>
required
Available options:
pending
id
string<uuid>
required
redirect_url
string

Dashboard path. Ignore for API clients.