---
title: "Set Usage Entitlement"
method: PUT
path: "/v1/usage/entitlements/{subject}"
tags: ["usage"]
---

# Set Usage Entitlement

`PUT /v1/usage/entitlements/{subject}`

## Request

- Base URL: `https://api.tmcra.com`
- URL: `https://api.tmcra.com/v1/usage/entitlements/{subject}`
- Auth: HTTP bearer

## Path parameters

- `subject` string, required

## Headers

- `X-TMCRA-On-Behalf-Of-Subject` string, nullable: Trusted subject attribution for server-side control-plane proxies. Requires a tokens:manage API key.

## Request body

- EntitlementUpdateRequest
  - `ingest_raw_tokens` integer, nullable, required
  - `recall_requests` integer, nullable, required

## Response `200`

Successful Response

- QuotaView
  - `ingest_raw_tokens` QuotaMetricView, required
    - `limit` integer, nullable
    - `remaining` integer, nullable
    - `used` integer, required
  - `plan` 'pilot'
  - `principal` string, required
  - `recall_requests` QuotaMetricView, required
    - `limit` integer, nullable
    - `remaining` integer, nullable
    - `used` integer, required
  - `tenant_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tmcra/apis/tmcra-memory-api.md) · [All operations](https://skmtc.dev/tmcra/apis/tmcra-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tmcra/apis/tmcra-memory-api/revisions/597be9dc7a3d?raw)