Entitlements
What the current plan allows. Read this instead of hard-coding limits, and instead of discovering them by hitting a 422.
This endpoint ignores X-Postlyra-Brand
It reads your currently-selected brand. Call PATCH /me/team first to target a specific one.
GET /me/entitlements
curl https://api.postlyra.com/me/entitlements \
-H "Authorization: Bearer $POSTLYRA_TOKEN"{
"team_id": 1,
"plan": { "id": 3, "slug": "solo", "name": "Solo" },
"entitlements": {
"brands": { "type": "limit", "value": 1, "available": true, "source": "plan" },
"ai_credits_monthly": { "type": "limit", "value": 10000, "available": true, "source": "plan" },
"storage_limit": { "type": "limit", "value": 5, "available": true, "source": "plan", "used": 1.482 },
"staff_accounts": { "type": "limit", "value": 2, "available": true, "source": "plan" },
"automations": { "type": "limit", "value": 3, "available": true, "source": "plan" }
}
}Reading a value
| Field | Meaning |
|---|---|
type | limit, boolean or enum |
value | The allowance. For a limit, null means unlimited |
available | Whether the feature is usable at all |
source | plan, grant or default |
is_unlimited | Present on a limit with no ceiling |
used | Present on storage_limit only, in GB to 3 decimals |
A feature that is switched off entirely is omitted from the response, not returned as false. Treat a missing key as unavailable.
source tells you where the value came from: plan is the plan's default, grant is an override applied to this account specifically, and default means neither applied.
The allowances
| Key | Controls |
|---|---|
brands | How many brands the account can create |
ai_credits_monthly | Monthly AI generation budget |
storage_limit | Media storage, in GB |
staff_accounts | Member seats per brand |
automations | How many automations can be active at once |
Where they bite
| Allowance | Enforced on |
|---|---|
storage_limit | POST /media, returns 422 |
staff_accounts | POST /users, returns 422 with limit_reached |
brands | Creating a brand in Studio |
automations | Activating an automation in Studio |
ai_credits_monthly | Any AI generation in Studio |
Trials
An account on trial resolves against a hidden trial plan: 1 brand, 10,000 AI credits, 5 GB storage, 2 seats, 3 automations. An account past its trial with no subscription has no plan, so plan is null and most allowances are unavailable.
GET /subscription/status tells you which state you are in. See Subscription.