Files

List files

GET/v1/files

Lists files for a provider.

Query Parameters

x-model-provider*string

Provider to list files for

Value in"openai" | "azure" | "anthropic" | "bedrock" | "cohere" | "vertex" | "vllm" | "mistral" | "ollama" | "groq" | "sgl" | "parasail" | "perplexity" | "replicate" | "cerebras" | "gemini" | "openrouter" | "elevenlabs" | "huggingface" | "nebius" | "xai" | "runway" | "fireworks"
purpose?string

Filter by purpose

Value in"batch" | "assistants" | "fine-tune" | "vision" | "batch_output" | "user_data" | "responses" | "evals"
limit?integer

Maximum number of files to return

Range1 <= value
after?string

Cursor for pagination

order?string

Sort order (asc/desc)

Value in"asc" | "desc"

Response Body

application/json

application/json

application/json

curl -X GET "http://localhost:8080/v1/files?x-model-provider=openai"
{
  "object": "string",
  "data": [
    {
      "id": "string",
      "object": "string",
      "bytes": 0,
      "created_at": 0,
      "filename": "string",
      "purpose": "batch",
      "status": "uploaded",
      "status_details": "string",
      "expires_at": 0
    }
  ],
  "has_more": true,
  "after": "string",
  "extra_fields": {
    "request_type": "string",
    "provider": "openai",
    "model_requested": "string",
    "model_deployment": "string",
    "latency": 0,
    "chunk_index": 0,
    "raw_request": {},
    "raw_response": {},
    "cache_debug": {
      "cache_hit": true,
      "cache_id": "string",
      "hit_type": "string",
      "requested_provider": "string",
      "requested_model": "string",
      "provider_used": "string",
      "model_used": "string",
      "input_tokens": 0,
      "threshold": 0,
      "similarity": 0
    }
  }
}
{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}
{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}