List organization models

Returns all models (built-in + custom) for the current organization.

GET/api/models

Authorization

better-auth.session_token<token>

Cookie session from Better Auth. Requires X-Org-Id header for org-scoped routes.

In: cookie

Header Parameters

X-Org-Id?string

Organization ID. Required for cookie auth. Not needed for API key auth (org resolved from key).

Formatuuid

curl -X GET "https://your-instance/api/models"

{
  "object": "list",
  "hasMore": false,
  "data": [
    {
      "id": "gpt-4o",
      "label": "GPT-4o",
      "providerId": "openai",
      "provider_name": "OpenAI",
      "pi_provider": "openai",
      "pi_dialect": {
        "name": "GPT-4o"
      },
      "apiShape": "openai-responses",
      "base_url": "https://api.openai.com/v1",
      "modelId": "gpt-4o",
      "generation": {
        "temperature": "supported",
        "reasoning": {
          "supported": "unsupported",
          "adaptive": null,
          "levels": {}
        }
      },
      "iconUrl": "openai",
      "source": "built-in",
      "enabled": true,
      "is_default": false,
      "needs_reconnection": false,
      "aliased": false,
      "credentialId": "pk_abc123",
      "contextWindow": 128000,
      "maxTokens": 16384,
      "reasoning": false,
      "created_by": null,
      "createdAt": "2026-01-10T08:00:00Z",
      "updatedAt": "2026-01-10T08:00:00Z"
    }
  ]
}

{
  "type": "https://docs.appstrate.dev/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing session",
  "code": "unauthorized",
  "request_id": "req_abc123"
}

{
  "type": "https://docs.appstrate.dev/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Insufficient permissions",
  "code": "forbidden",
  "request_id": "req_abc123"
}