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
}

Authorizations

ManagementBearerAuthBasicAuth

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

• a Bifrost management API key,
• a dashboard session token issued by POST /api/session/login,
• base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

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>