Agent Knowledge Files

Create Knowledge File

Changed on

Create a knowledge file and start its upload.

Text files are stored immediately and begin indexing, so they come back as processing and are ready to attach to an agent once they read available. PDF files begin a chunked upload: use the returned ID to upload each chunk via PUT /{id}/upload, then finalize with POST /{id}/submit.

post/v1/knowledge-files

Request

  • Base URL
    https://api.bey.dev
  • URL
    https://api.bey.dev/v1/knowledge-files
  • Auth
    API key in header x-api-key

Request body

OR

Example request

{
  "name": "Hitchhiker's Guide to the Galaxy"
}

Response

Created Knowledge File

OR
OR
OR

Example response

{
  "id": "01234567-89ab-cdef-0123-456789abcdef",
  "name": "Hitchhiker's Guide to the Galaxy"
}

Changes