> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Included Workspace Settings

> Read extra usage, usage requests, the workspace extra usage cap, and the default limit on each plan

Read and update extra usage for mode `ai-models-included`. Amounts are euros.

The call uses the workspace API key's `BILLING_API` scope. Writes run as the key's service account owner.

> [!NOTE]
>
> Call these routes when `GET /billing/v1/mode` returns `ai-models-included`. Dedicated deployments always return `bring-your-own-keys`, including when Langdock manages the model keys. The other mode returns `409` with `code` `BILLING_MODE_MISMATCH`.

## Base URL

```
https://api.langdock.com/billing/v1/ai-models-included/settings
```

## Prerequisites

* **API key** with the `BILLING_API` scope
* The key owner is a service account that has not been deleted and has an active Admin membership

## Read settings

`GET /billing/v1/ai-models-included/settings` returns the current settings.

```json theme={null}
{
  "currency": "EUR",
  "extraUsageEnabled": true,
  "usageRequestsEnabled": true,
  "workspaceExtraUsageLimit": { "type": "limited", "amount": 2000 },
  "defaultExtraUsageLimitPerPlan": {
    "business": { "type": "limited", "amount": 50 },
    "business_max": { "type": "limited", "amount": 150 }
  },
  "extraUsagePeriod": {
    "start": "2026-09-01T00:00:00.000Z",
    "end": "2026-10-01T00:00:00.000Z"
  },
  "extraUsagePeriodSpend": 412.35
}
```

`extraUsageEnabled` turns extra usage on or off for the workspace. When it is off, every member's effective extra usage limit is zero, with `source` `workspace`. Configured member and group limits stay in place for when you turn extra usage on again.

`workspaceExtraUsageLimit` caps extra usage in `extraUsagePeriod`. Chat, agent, and personal API key usage count toward that cap, and so do Agent API calls with a workspace key when the agent budget is `always` with a limited amount. Other workspace API usage, workflow runs, and custom model usage do not. See [Extra usage](https://docs.langdock.com/en/admin/manage-usage/extra-usage.md). An unlimited member or group limit does not remove it. `extraUsagePeriodSpend` is the usage counted toward the cap. It is `null` when the workspace hides per user spend.

`defaultExtraUsageLimitPerPlan` is the default extra usage limit for **Business** (`business`) and **Business Max** (`business_max`). A member who inherits uses these defaults together with group limits. See [Get Included User](https://docs.langdock.com/en/developer/billing-api/get-included-user.md).

`usageRequestsEnabled` lets members ask an admin for more usage.

> [!NOTE]
>
> Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on [API Key Best Practices](https://docs.langdock.com/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.