Upload skill file

Uploads one file for later attachment to a skill version. The response contains either an object-storage key or a database blob ID.

POST /api/skills/files/upload

Error

A valid request URL is required to generate request examples

200

{
  "upload_id": "<string>",
  "storage_key": "<string>",
  "blob_id": "<string>",
  "path": "<string>",
  "filename": "<string>",
  "mime_type": "<string>",
  "file_size_bytes": 123
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

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

200

application/json

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>