Skip to main content
GET
/
files
List files
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.phaseo.app/v1/files', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "error": "error_type",
  "ok": false,
  "message": "Human-readable error message",
  "description": "Additional error details.",
  "generation_id": "G-abc123",
  "status_code": 502,
  "error_type": "system",
  "error_origin": "upstream",
  "reason": "all_candidates_failed",
  "attempt_count": 2,
  "failed_providers": [
    "google-ai-studio",
    "openai"
  ],
  "failed_statuses": [
    403,
    429
  ],
  "upstream_error": {
    "code": "PERMISSION_DENIED",
    "message": "The caller does not have permission.",
    "description": "<string>",
    "param": "<string>"
  },
  "failure_sample": [
    {
      "provider": "<string>",
      "type": "<string>",
      "status": 123,
      "upstream_error_code": "<string>",
      "upstream_error_message": "<string>",
      "upstream_error_description": "<string>",
      "upstream_error_param": "<string>",
      "upstream_payload_preview": "<string>",
      "retryable": true
    }
  ],
  "provider_failure_diagnostics": {
    "hint": "<string>",
    "provider": "<string>"
  },
  "routing_diagnostics": {
    "filterStages": [
      {
        "stage": "<string>",
        "beforeCount": 123,
        "afterCount": 123,
        "droppedProviders": [
          {
            "providerId": "<string>",
            "reason": "<string>"
          }
        ]
      }
    ]
  },
  "provider_candidate_diagnostics": {
    "totalProviders": 123,
    "supportsEndpointCount": 123,
    "candidateCount": 123,
    "droppedUnsupportedEndpoint": [
      "<string>"
    ],
    "droppedMissingAdapter": [
      {
        "providerId": "<string>",
        "endpoint": "<string>"
      }
    ]
  },
  "provider_enablement": {
    "capability": "<string>",
    "providersBefore": [
      "<string>"
    ],
    "providersAfter": [
      "<string>"
    ],
    "dropped": [
      {
        "providerId": "<string>",
        "reason": "<string>"
      }
    ]
  },
  "missing_pricing_providers": [
    "<string>"
  ],
  "provider_payment_required_provider": "openai",
  "provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
  "details": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.ai-stats.phaseo.app/llms.txt

Use this file to discover all available pages before exploring further.

The public files routes are currently mounted but temporarily disabled, so this route currently returns 501 not_implemented.
Use file ids captured at upload time instead of depending on this endpoint when you are using the shared gateway key.

Authorizations

Authorization
string
header
required

Bearer token authentication

Response

File listing is not supported in the current gateway mode

error
required
Example:

"error_type"

ok
boolean
Example:

false

message
string
Example:

"Human-readable error message"

description
string
Example:

"Additional error details."

generation_id
string
Example:

"G-abc123"

status_code
integer
Example:

502

error_type
enum<string>
Available options:
user,
system
Example:

"system"

error_origin
enum<string>
Available options:
user,
gateway,
upstream
Example:

"upstream"

reason
string
Example:

"all_candidates_failed"

attempt_count
integer
Example:

2

failed_providers
string[]
Example:
["google-ai-studio", "openai"]
failed_statuses
integer[]
Example:
[403, 429]
upstream_error
object
failure_sample
object[]
provider_failure_diagnostics
object
routing_diagnostics
object
provider_candidate_diagnostics
object
provider_enablement
object
missing_pricing_providers
string[]
provider_payment_required_provider
string
Example:

"openai"

provider_payment_required_support_notice
string
Example:

"Our upstream provider billing appears to be unavailable. If this persists, contact support."

details
object[]
Last modified on May 19, 2026