Skip to content

SubscriptionListItem

Sanitised subscription view returned by the maas-api passthrough endpoint, safe to expose to basic users

Type: object

Properties

Property Type Required Description
subscription_id_header string Yes

Subscription name to use in the X-MaaS-Subscription header

Example: premium-team-sub
subscription_description string Yes

Human-readable description (falls back to display-name, then name)

Example: Premium Team Subscription
display_name string No

Display name from the openshift.io/display-name annotation

Example: Premium Team
inference_priority integer (int32) No

Subscription inference priority (higher = higher priority). Omitted when unset; the scheduler applies default 0.

Example: 10
model_refs array of ModelRefInfo Yes

Model references with rate limits
organization_id string No

Organization identifier for metering and billing

Example: premium-org
cost_center string No

Cost center for usage attribution

Example: engineering
key_count integer (int32) No

Number of API keys associated with this subscription for the current user

Example: 10
labels map of string No

Additional labels for tracking and metrics

Example

{
  "subscription_id_header": "premium-team-sub",
  "subscription_description": "Premium Team Subscription",
  "display_name": "Premium Team",
  "inference_priority": 10,
  "model_refs": [
    {
      "name": "granite-3-8b-instruct",
      "display_name": "Granite 3 8B Instruct",
      "source": "internal",
      "description": "Granite 3 8B Instruct is a large language model that is used for advanced tasks.",
      "namespace": "maas-models",
      "token_rate_limits": [
        {
          "limit": 100000,
          "window": "24h"
        }
      ],
      "billing_rate": {
        "per_token": "0.001"
      }
    }
  ],
  "organization_id": "premium-org",
  "cost_center": "engineering",
  "key_count": 10,
  "labels": {
    "env": "production"
  }
}