---
title: "Create or update one flat entitlement add-on record"
method: PUT
path: "/v1/billing/entitlements/{addon}"
tags: ["billing", "admin"]
---

# Create or update one flat entitlement add-on record

`PUT /v1/billing/entitlements/{addon}`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/billing/entitlements/{addon}`
- Auth: HTTP bearer

## Path parameters

- `addon` string, required

## Request body

- PutEntitlementRequest
  - `principal_id` string
  - `subscription_reference` string, required

## Response `201`

Entitlement record.

- EntitlementEnvelope
  - `status` 'success', required
  - `entitlement` object, required

## Other responses

- `400`: Validation error.
- `401`: Unauthorized.
- `403`: Forbidden.
- `503`: Entitlements are not configured.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)