subscriptions

Update an existing subscription

Updates an existing MaaSSubscription and its associated MaaSAuthPolicy. K8s calls: PUT /k8s/v1/maassubscription/:name, PUT /k8s/v1/maasauthpolicy/:name

put/api/v1/update-subscription/{name}

Path parameters

namestring required

Name of the MaaSSubscription to update

Request body

displayNamestring

Updated display name for the subscription

descriptionstring

Updated description for the subscription

priorityinteger

Updated subscription priority

Example request

{
  "displayName": "Premium Team Subscription",
  "description": "This subscription is for the premium team",
  "owner": {
    "groups": [
      {
        "name": "premium-users"
      }
    ]
  },
  "modelRefs": [
    {
      "name": "llama-2-7b-chat",
      "namespace": "maas-models",
      "tokenRateLimits": [
        {
          "limit": 100000,
          "window": "24h"
        }
      ],
      "billingRate": {
        "perToken": "0.0001"
      }
    }
  ],
  "tokenMetadata": {
    "organizationId": "org-123",
    "costCenter": "engineering"
  }
}

Response

Subscription and auth policy updated successfully

Example response

{
  "subscription": {
    "name": "premium-team-sub",
    "displayName": "Premium Team Subscription",
    "description": "This subscription is for the premium team",
    "namespace": "maas-system",
    "phase": "Active",
    "statusMessage": "successfully reconciled",
    "reason": "Reconciled",
    "status": "True",
    "conditionType": "Ready",
    "lastTransitionTime": "2026-01-01T00:00:00Z",
    "priority": 10,
    "owner": {
      "groups": [
        {
          "name": "premium-users"
        }
      ]
    },
    "modelRefs": [
      {
        "name": "llama-2-7b-chat",
        "namespace": "maas-models",
        "tokenRateLimits": [
          {
            "limit": 100000,
            "window": "24h"
          }
        ],
        "billingRate": {
          "perToken": "0.0001"
        }
      }
    ],
    "tokenMetadata": {
      "organizationId": "org-123",
      "costCenter": "engineering"
    }
  },
  "authPolicy": {
    "name": "premium-team-sub-policy",
    "namespace": "maas-system",
    "displayName": "Premium Team Policy",
    "description": "High-priority access policy for the premium team.",
    "phase": "Active",
    "statusMessage": "successfully reconciled",
    "reason": "Reconciled",
    "status": "True",
    "conditionType": "Ready",
    "lastTransitionTime": "2026-01-01T00:00:00Z",
    "creationTimestamp": "2025-03-01T10:00:00Z",
    "modelRefs": [
      {
        "name": "llama-2-7b-chat",
        "namespace": "maas-models"
      }
    ],
    "subjects": {
      "groups": [
        {
          "name": "premium-users"
        }
      ]
    },
    "meteringMetadata": {
      "organizationId": "org-123",
      "costCenter": "engineering"
    }
  }
}

Changes

Changed in 9 of the 33 revisions of this API.2220

Aug 6, 20269112415ceeca8See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Apr 23, 202616b3a54841ce2See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Apr 15, 2026b1e5c0b1fe192See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Apr 10, 2026cf6b85982e173See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Apr 6, 202632fce875199e22See the full diff
- ●
  removed the request property //
  request-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
Mar 30, 2026b624ef0376c52See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Mar 23, 20261428a3203bfb1See the full diff
- ▲
  the response property became optional for the status
  response-property-became-optional
Mar 18, 20264e69495b0c8e1See the full diff
- ○
  endpoint added
  endpoint-added
Feb 2, 20262321745544981See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 41 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history