Catalog

Read-only lists of the models and regions your organization can use.

Why this lives on the Management API: it is the vocabulary allowlists are written in. Before a pipeline writes a project's model allowlist, it should validate every id it is about to write against this list. A management client that guesses model ids will guess wrong.

This API reflects the catalog; it never changes it. At inference time, GET /v1/models lists what one key can route to.

List models

GET /api/v1/mgmt/catalog/models

The live model catalog as the portal's Models page shows it: enabled models only — disabled and retired models never appear. Each entry is the public model card, the same object GET /v1/models returns, priced at the rate your organization is billed, plus four Management API fields: mode, status, capabilities and regions. Ordered by id descending (the catalog has no creation time); paginated with limit and cursor like every other list.

id, name, object, created, owned_by, architecture, top_provider, mode, status, capabilities and regions are always present. Every other card field is omitted when the catalog has no value for that model.

pricing is the same object as on GET /v1/models: every price is a decimal string in USD per one unit, and unit says what the unit is.

A field appears only when the model has that price: an embedding model has no completion, and when input_cache_read / input_cache_write are absent, cached tokens are billed at prompt. A model without pricing has an unknown price, not a free one. To quote per 1M tokens, multiply prompt by 1,000,000.

curl -G https://portal.<domain>/api/v1/mgmt/catalog/models \
  -H "Authorization: Bearer $TF_PAT" \
  -d limit=200

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['TF_PAT']}"}
url = "https://portal.<domain>/api/v1/mgmt/catalog/models"
models, params = [], {"limit": 200}
while True:
    page = requests.get(url, headers=headers, params=params, timeout=30).json()
    models += page["data"]
    if not page["has_more"]:
        break
    params["cursor"] = page["next_cursor"]
known = {m["id"]: m for m in models}

allowlist = ["openai/gpt-4o", "openai/gpt-4o-mini"]
missing = [m for m in allowlist if m not in known]
ending = [m for m in allowlist if m in known and known[m].get("expiration_date")]
if missing:
    raise SystemExit(f"unknown models in allowlist: {missing}")

{
  "data": [
    {
      "id": "openai/gpt-4o",
      "name": "GPT-4o",
      "object": "model",
      "created": 1715558400,
      "owned_by": "Token Factory",
      "description": "OpenAI's multimodal flagship.",
      "context_length": 128000,
      "context_window": 128000,
      "max_output": 16384,
      "architecture": {
        "modality": "text+image->text",
        "input_modalities": ["text", "image"],
        "output_modalities": ["text"]
      },
      "pricing": {
        "unit": "token",
        "prompt": "0.0000025",
        "completion": "0.00001",
        "input_cache_read": "0.00000125"
      },
      "top_provider": { "context_length": 128000, "max_completion_tokens": 16384, "is_moderated": false },
      "supported_parameters": ["max_tokens", "stop", "temperature", "tool_choice", "tools", "top_p"],
      "knowledge_cutoff": "2023-10",
      "mode": "chat",
      "status": "ready",
      "capabilities": { "vision": true, "tools": true },
      "regions": ["default"]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

A model with an expiration_date is still callable until that date; plan the move off it before then.

List regions

GET /api/v1/mgmt/catalog/regions

Derived from the model list: the distinct regions your organization's models are served in, with how many models each serves. Paginated.

curl https://portal.<domain>/api/v1/mgmt/catalog/regions \
  -H "Authorization: Bearer $TF_PAT"

regions = requests.get("https://portal.<domain>/api/v1/mgmt/catalog/regions", headers=headers, timeout=30).json()["data"]

{
  "data": [
    { "id": "default", "model_count": 42 }
  ],
  "has_more": false,
  "next_cursor": null
}

Errors specific to the catalog