Update a group

Update a Frontier Gateway group’s display name or model configuration. Hierarchy and enforcement mode are immutable.

curl

curl --request PATCH \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash \
  --header "Authorization: Api-Key $BASETEN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "models": [
      {
        "slug": "your-org/your-model",
        "rate_limits": [
          { "type": "TOKEN", "unit": "MINUTE", "threshold": 1500000 }
        ]
      }
    ]
  }'

200

{
  "id": "abc123hash",
  "metadata": { "name": "Acme prod", "external_entity_id": "cust_42" },
  "models": [
    {
      "slug": "your-org/your-model",
      "rate_limits": [
        { "type": "TOKEN", "unit": "MINUTE", "threshold": 1500000 }
      ],
      "usage_limits": []
    }
  ],
  "effective_models": [
    {
      "slug": "your-org/your-model",
      "rate_limits": [
        { "type": "TOKEN", "unit": "MINUTE", "threshold": 1500000, "source_group": "abc123hash" }
      ],
      "usage_limits": []
    }
  ],
  "hierarchy": { "limit_enforcement": "INDEPENDENT", "parent_group_id": null },
  "created_at": "2026-05-13T12:00:00Z"
}

Update a group’s mutable fields. You can change metadata.name and the models configuration; the hierarchy block (parent and enforcement mode) is immutable after creation. At least one field must be provided.

The models list, when provided, replaces the group’s full model set with set semantics: slugs absent from the new list are removed, and slugs that are new to the group are added.

Errors

Status	Meaning
400 Bad Request	Empty body, invalid limit shape, or (in a cascading hierarchy) a change that would put this group above an ancestor or below an existing descendant. Lower descendants before lowering the parent, and raise ancestors before raising descendants. See Cascading mode.
403 Forbidden	The group exists but isn’t in your workspace, or the caller doesn’t have management scope.
404 Not Found	No group with this id in your workspace, or it has been deleted.

curl

curl --request PATCH \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash \
  --header "Authorization: Api-Key $BASETEN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "models": [
      {
        "slug": "your-org/your-model",
        "rate_limits": [
          { "type": "TOKEN", "unit": "MINUTE", "threshold": 1500000 }
        ]
      }
    ]
  }'

200

{
  "id": "abc123hash",
  "metadata": { "name": "Acme prod", "external_entity_id": "cust_42" },
  "models": [
    {
      "slug": "your-org/your-model",
      "rate_limits": [
        { "type": "TOKEN", "unit": "MINUTE", "threshold": 1500000 }
      ],
      "usage_limits": []
    }
  ],
  "effective_models": [
    {
      "slug": "your-org/your-model",
      "rate_limits": [
        { "type": "TOKEN", "unit": "MINUTE", "threshold": 1500000, "source_group": "abc123hash" }
      ],
      "usage_limits": []
    }
  ],
  "hierarchy": { "limit_enforcement": "INDEPENDENT", "parent_group_id": null },
  "created_at": "2026-05-13T12:00:00Z"
}

Authorizations

Authorization · string · header · required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Path Parameters

group_id · string · required

Body

application/json

metadata · UpdateGroupMetadataV1 · object | null

Mutable group metadata.

Show child attributes

Example:

{ "name": "Acme Prod" }

models · ModelConfigV1 · object[] | null

Per-model rate and usage limit configuration.

Show child attributes

Response

200 - application/json

id · string · required

Internal Baseten ID for the group.

metadata · GroupMetadataV1 · object · required

Group identity + display metadata.

Show child attributes

hierarchy · GroupHierarchyV1 · object · required

Parent linkage and limit enforcement mode. Parent is null for root groups.

Show child attributes

created_at · string<date-time> · required

When this group was created.

models · ModelConfigV1 · object[]

Show child attributes

effective_models · EffectiveModelConfigV1 · object[]

Show child attributes