Skip to main content
POST
/
api
/
skills
/
files
/
upload
Error
A valid request URL is required to generate request examples
{
  "upload_id": "<string>",
  "storage_key": "<string>",
  "blob_id": "<string>",
  "path": "<string>",
  "filename": "<string>",
  "mime_type": "<string>",
  "file_size_bytes": 123
}

Authorizations

​
Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Body

multipart/form-data
​
file
file
required

File to upload. Exactly one file part is accepted.

​
path
string

Optional relative path to store with the uploaded file.

Example:

"references/style-guide.md"

Response

File uploaded successfully

​
upload_id
string
​
storage_key
string

Object-storage key when object storage is configured.

​
blob_id
string

DB blob ID when object storage is not configured.

​
path
string
​
filename
string
​
mime_type
string
​
file_size_bytes
integer<int64>