List models from the catalogue

curl --request GET \
  --url https://{host}/v2/workspaces/slug:llm-gateway/webhooks/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{host}/v2/workspaces/slug:llm-gateway/webhooks/v1/models', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{host}/v2/workspaces/slug:llm-gateway/webhooks/v1/models"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "model_id": "<string>",
      "display": {
        "name": "<string>",
        "brand": "<string>",
        "hidden": true
      },
      "capabilities": {
        "vision": true,
        "audio": true,
        "text": true,
        "image": true
      },
      "limits": {},
      "failover": "<string>",
      "region": "<string>",
      "dimensions": "<unknown>",
      "supported_dimensions": [
        123
      ],
      "metrics": "<unknown>",
      "provider_config": {},
      "pricing": {
        "input_per_1m_tokens": 123,
        "output_per_1m_tokens": 123
      },
      "tags": [
        "<string>"
      ],
      "org_slugs": [
        "<string>"
      ],
      "enabled": true
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": {},
  "status": 123,
  "retryAfter": 123,
  "provider": "<string>",
  "model": "<string>",
  "provider_error_type": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": {},
  "status": 123,
  "retryAfter": 123,
  "provider": "<string>",
  "model": "<string>",
  "provider_error_type": "<string>"
}

Models

List models from the catalogue

Returns a paginated, filterable list of models from the gateway catalogue.

Note. The response uses Prisme.ai’s standard pagination envelope ({ items, total, page, limit }), not OpenAI’s { object: "list", data: [...] } shape - this endpoint is the management catalogue, not the OpenAI-compatible model listing.

Per-org availability filter:

No orgSlug query → restrict to models reachable from the current session (no org_slugs constraint, or the session’s org is listed).
orgSlug=all (admin only) → returns the full catalogue regardless of per-model org_slugs.
orgSlug=<slug> (admin only) → impersonate that org’s view.

GET

models

List models from the catalogue

curl --request GET \
  --url https://{host}/v2/workspaces/slug:llm-gateway/webhooks/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{host}/v2/workspaces/slug:llm-gateway/webhooks/v1/models', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{host}/v2/workspaces/slug:llm-gateway/webhooks/v1/models"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "model_id": "<string>",
      "display": {
        "name": "<string>",
        "brand": "<string>",
        "hidden": true
      },
      "capabilities": {
        "vision": true,
        "audio": true,
        "text": true,
        "image": true
      },
      "limits": {},
      "failover": "<string>",
      "region": "<string>",
      "dimensions": "<unknown>",
      "supported_dimensions": [
        123
      ],
      "metrics": "<unknown>",
      "provider_config": {},
      "pricing": {
        "input_per_1m_tokens": 123,
        "output_per_1m_tokens": 123
      },
      "tags": [
        "<string>"
      ],
      "org_slugs": [
        "<string>"
      ],
      "enabled": true
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": {},
  "status": 123,
  "retryAfter": 123,
  "provider": "<string>",
  "model": "<string>",
  "provider_error_type": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": {},
  "status": 123,
  "retryAfter": 123,
  "provider": "<string>",
  "model": "<string>",
  "provider_error_type": "<string>"
}

Authorizations

Authorization

string

header

required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Query Parameters

limit

string

Page size (capped server-side at 100, default 100).

page

string

Zero-based page index.

type

enum<string>

Filter by model type.

Available options:

completion,

embeddings,

image_generation

enabled

enum<string>

Filter by enabled flag.

Available options:

true,

false

model_ids

string

Comma-separated list of model IDs.

Response

Paginated list of models.

Pagination envelope used by GET /v1/models (Prisme.ai standard, not OpenAI's { object: "list", data: [...] }).

items

object[]

required

Hide child attributes

items.model_id

string

required

Stable identifier (matches the value sent in request.model).

Maximum string length: 128

items.type

enum<string>

required

Model family.

Available options:

completion,

embeddings,

image_generation

Maximum string length: 64

items.display

object

Display metadata (label, brand, hidden flag).

Hide child attributes

items.display.name

string

items.display.brand

string

items.display.hidden

boolean

items.capabilities

object

Flags advertising what the model supports.

Hide child attributes

items.capabilities.vision

boolean

items.capabilities.audio

boolean

items.capabilities.text

boolean

items.capabilities.image

boolean

items.limits

object

Provider-side limits (e.g. context window, max tokens).

items.failover

string

Optional model_id to route to when the primary fails.

Maximum string length: 128

items.region

string

Hosting region (free-text).

Maximum string length: 64

items.dimensions

any

Default embedding dimensionality (embeddings models only).

items.supported_dimensions

number[]

Allowed values for the request dimensions parameter.

items.metrics

any

Free-form metrics block (latency, throughput hints, …).

items.provider_config

object

Provider-specific configuration (batch size, parallelism, …).

items.pricing

object

Cost configuration used to compute usage.cost.

Hide child attributes

items.pricing.input_per_1m_tokens

number<double>

items.pricing.output_per_1m_tokens

number<double>

items.tags

string[]

Free-form tags used by the search/filter UI.

items.org_slugs

string[]

When set and non-empty, restricts the model to the listed organizations. Empty / missing means the model is available to all orgs (subject to governance overlays).

items.enabled

boolean

When false, the model is hidden from routing.

total

integer

required

Total number of matching documents (ignoring pagination).

page

integer

required

Zero-based page index.

limit

integer

required

Effective page size (server-capped at 100).

⌘I

Introduction

Platform API

Agent Creator API

LLM Gateway API

Governance API

Knowledges API

Collections API

List models from the catalogue

Authorizations

Query Parameters

Response