Skip to main content
POST
Add a knowledge base source — file, URL, or inline text (auto-creates the KB)

Authorizations

Authorization
string
header
required

Your API key sent as a Bearer credential — Authorization: Bearer <api_key>, where <api_key> starts with oi_sk_ (create one via POST /v1/api-keys). Although the field is labelled 'token', paste your API key here. A dashboard JWT is also accepted on this header for the same endpoints.

Body

multipart/form-data
type
enum<string>
required
Available options:
url
Example:

"url"

source
string
required

Publicly accessible URL to crawl. OneInbox reads all linked pages automatically.

Example:

"https://docs.yourproduct.com/faq"

Response

Successful Response

201 response for POST /sources — returns the source and a job_id to poll.

source
KBSourceResponse · object
required
job
KBJobResponse · object
required
message
string
default:Source accepted. Ingestion is running in the background. Poll GET /v1/knowledge-bases/{kb_id}/jobs/{job_id} for status.