Sign in
models

List All Model Aliases

Changed on

Retrieves paginated list of all configured model aliases including user-defined aliases, model aliases, and API provider aliases with server-side facet filtering (type, api_format, size range, capability) and sorting. Requires any authenticated user (User level permissions or higher).

get/bodhi/v1/models

Request

  • Base URL: http://localhost:1135
  • URL: http://localhost:1135/bodhi/v1/models
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /bodhi/v1/auth/initiate, token URL /bodhi/v1/auth/callback, scopes: resource_user)

Query parameters

pageinteger

Page number (1-based indexing)

page_sizeinteger

Number of items to return per page (maximum 100)

sortstring

Field to sort by. Common values: repo, filename, size, updated_at, snapshot, created_at

sort_orderstring

Sort order: 'asc' for ascending, 'desc' for descending

typestring

Alias type facet (comma-separated): local_file, model_alias, api_model, fallback.

api_formatstring

API-format facet (comma-separated), API rows only: openai, responses, anthropic, gemini, liberty. anthropic matches both anthropic and anthropic_oauth aliases.

size_mininteger

Minimum local-file size in bytes (inclusive). Applies to local rows with a known size; rows without a size (API/router) are not filtered out by size.

size_maxinteger

Maximum local-file size in bytes (inclusive). See size_min.

capabilitystring

Capability facet (comma-separated), local rows only: vision, tool_use, reasoning. A row passes only if it has metadata with every requested capability set true.

searchstring

Free-text search (case-insensitive substring) over a row's identifying fields — alias/name, repo, filename for local rows; id, name, base_url for API rows; alias for routers.

Response

Paginated list of model aliases retrieved successfully

totalinteger required
pageinteger required
page_sizeinteger required

Changes

  • 470bb36dd788Revision changes
    • info

      added subschema #2 to the /////// response property allOf list for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 from the /////// response property oneOf list for the response status

    • info

      added the required property ////// to the response with the status

    • info

      added the required property ////// to the response with the status

    • info

      added the required property ////// to the response with the status

  • 5a667cb41584Revision changes
    • info

      added the optional property /////// to the response with the status