Clean up orphan skill files

Deletes uploaded files that are not attached to any skill version. This is mostly a maintenance escape hatch: Bifrost also runs orphan cleanup on server startup. Non-forced cleanup preserves uploads newer than 24 hours so files are not deleted while a skill is still being edited.

DELETE /api/skills/files/orphans

Error

A valid request URL is required to generate request examples

200

{
  "deleted_db_blobs": 123,
  "deleted_storage_objects": 123,
  "object_storage_configured": true,
  "message": "<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.

Query Parameters

force · boolean · default: false

Bypass the 24-hour grace period when true.

Response

200

application/json

Cleanup completed

deleted_db_blobs · integer<int64>

deleted_storage_objects · integer

object_storage_configured · boolean

message · string