# Update

Launch stage: GA

`PATCH /api/2.1/accounts/{account_id}/budget-policies/{policy.policy_id}`

Updates a policy

API scopes: billing

## Path parameters

- `policy` (object, optional)
  The policy to update. `creator_user_id` cannot be specified in the request. All other fields
   must be specified even if not changed. The `policy_id` is used to identify the policy to
   update.
  - `policy_id` (string, optional)
    The Id of the policy. This field is generated by <Databricks> and globally unique.
    Constraints: `= 36 characters`
  - `policy_name` (string, optional)
    The name of the policy.
       - Must be unique among active policies.
       - Can contain only characters from the ISO 8859-1 (latin1) set.
       - Can't start with reserved keywords such as `databricks:default-policy`.
    Constraints: `[ 1 .. 127 ] characters`
  - `custom_tags` (array of object, optional)
    A list of tags defined by the customer. At most 20 entries are allowed per policy.
    - `key` (string, optional)
      The key of the tag.
         - Must be unique among all custom tags of the same policy
         - Cannot be “budget-policy-name”, “budget-policy-id” or "budget-policy-resolution-result" -
           these tags are preserved.
      Constraints: `[ 1 .. 512 ] characters`
    - `value` (string, optional)
      The value of the tag.
      Constraints: `<= 256 characters`
  - `binding_workspace_ids` (array of int64, optional)
    List of workspaces that this budget policy will be exclusively bound to.
     An empty binding implies that this budget policy is open to any workspace in the account.
- `account_id` (string, optional)
  The account Id of the customer

## Query parameters

- `limit_config` (object, optional)
  DEPRECATED. This is redundant field as LimitConfig is part of the BudgetPolicy

## Returns

Returns the BudgetPolicy object.

## Response

```json
{
  "policy_id": "string",
  "policy_name": "string",
  "custom_tags": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "binding_workspace_ids": [
    0
  ]
}
```