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

# update_quota

> Rename a quota, change its description or its default currency. Frequency and type stay on the web app.

Rename a quota, change its description or its default currency.

Pass at least one of `name`, `description` or `currency_type` — a call with
none of them has nothing to update. Sending the values the quota already has
changes nothing, so the same call can be sent twice.

A rename reaches every statement measuring against the quota: it reads under
its new name there too. A new `currency_type` only decides the currency of a
user's first target: a user who already holds targets on this quota keeps
theirs, which
[`update_quota_values`](https://docs.qobra.co/mcp_documentation/tools/update_quota_values) changes
per user.

The quota's frequency and type, and anything about a quota synchronized from
an integration beyond its name and description, can only be changed on its
page in the Qobra web app: they rewrite its stored targets or relaunch its
import. The call is refused when it would change the `currency_type` of a
synchronized quota.

The quota's environment (live or a sandbox) is the one the quota lives in.

Requires write permission on quotas. Available only where the Qobra write tools
beta is enabled. Every write to the live environment is recorded in the audit
trail as the `Qobra MCP` agent; writes to a sandbox are not audited.

```json Example arguments theme={null}
{
  "quota_id": "665f1c2e8a4b3d0012a7e9f1",
  "name": "New Business ARR 2027",
  "currency_type": "user"
}
```

## Parameters

> **Body**
>
> **quota\_id** `string` *required*
>
> Id of the quota to update — the id list\_quotas returns, or the one
> create\_quota just returned.
>
> **name** `string`
>
> New display name for the quota. Omit to leave the current name as it is.
>
> **description** `string`
>
> New free-text note about what the quota targets. Pass an empty string to
> clear it; omit to leave it as it is.
>
> **currency\_type** `string`
>
> New default currency for an amount quota: `company` (the company
> currency), `user` (each user's payment currency) or `calculation` (the
> user's calculation currency). Omit to leave it as it is. One of:
> `company`, `user`, `calculation`.

## Response

> **Body**
>
> **quota** `object`
>
> The quota as it now stands after the update — the same row list\_quotas
> returns.
>
> **object properties**
>
> **id** `string`
>
> **resource\_url** `string`
>
> Deep link to open this quota in the Qobra web app.
>
> **name** `string`
>
> **description** `string`
>
> **type** `string`
>
> Unit of the target value: amount (monetary, has a currency),
> percentage, or float (plain number). One of: `amount`, `percentage`,
> `float`.
>
> **frequency** `string`
>
> The period one target covers: monthly, quarterly, semesterly or
> annually.
>
> **currency\_type** `string`
>
> The quota's default currency for amount targets. A target value that
> carries its own currency overrides this default. One of: `company`,
> `user`, `calculation`.
>
> **archived** `boolean`
>
> **views** `object[]`
>
> The quota views the caller may query for this quota's values. See
> [`list_quotas`](https://docs.qobra.co/mcp_documentation/tools/list_quotas) for the full
> field breakdown.


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