---
title: "Update Spend Control"
method: PATCH
path: "/spend_controls/{spend_control_id}"
tags: ["Spend Controls"]
---

# Update Spend Control

`PATCH /spend_controls/{spend_control_id}`

Update spend control

## Path parameters

- `spend_control_id` string, uuid, required — The unique identifier of a spending control

## Request body

- SpendControlUpdateRequest
  - `action_case` boolean — If set, create a case for transactions that do not conform to the spend control
  - `action_decline` boolean — If set, decline transactions that do not conform to the spend control
  - `amount_limit` integer — Monetary limit for the spend control in the smallest currency unit (eg cents)
  - `direction` 'CREDITS' | 'DEBITS' — The direction of funds flow to which a spend control applies. To limit the rate of funds flowing out of an account, use DEBIT. To limit the rate of funds flowing in to an account, use CREDIT. If this is not set, the spend control applies to debits (ie spending) only.
  - `is_active` boolean — Indicates if spend control is active
  - `merchant_category_codes` string[] — merchant category codes for spend control
  - `name` string — Name assigned to spend control
  - `payment_sub_types` string[] — A list of payment sub-types to which a spend control will apply, if set. If not set or the array is empty, then the spend control will apply to all sub-types.
  - `payment_types` PaymentType[] — A list of payment types to which a spend control will apply, if set. If not set or the array is empty, then the spend control will apply to all types of payments.
  - `time_range` union — The time range to which the spend control applies
    - SpendControlTimeRangeType
      - `time_range_type` 'FOREVER' | 'ROLLING_WINDOW_DAYS' | 'SINGLE_TRANSACTION', required
    - SpendControlTimeRangeType
      - `time_range_type` 'FOREVER' | 'ROLLING_WINDOW_DAYS' | 'SINGLE_TRANSACTION', required
    - object
      - `days` integer, required — The number of days to define a rolling window for a spend control
      - `time_range_type` 'FOREVER' | 'ROLLING_WINDOW_DAYS' | 'SINGLE_TRANSACTION', required

## Response `200`

Spend control details

- SpendControlResponse
  - `number_of_related_accounts` integer, required — A count of how many accounts are using this spend control
  - `action_case` boolean, required — If set, create a case for transactions that do not conform to the spend control
  - `action_decline` boolean, required — If set, decline transactions that do not conform to the spend control
  - `amount_limit` integer, required — Monetary limit for the spend control in the smallest currency unit (eg cents)
  - `creation_time` string, date-time, required — The timestamp representing when the spend control was created
  - `direction` 'CREDITS' | 'DEBITS' — The direction of funds flow to which a spend control applies. To limit the rate of funds flowing out of an account, use DEBIT. To limit the rate of funds flowing in to an account, use CREDIT. If this is not set, the spend control applies to debits (ie spending) only.
  - `id` string, uuid, required — Spend Control ID
  - `is_active` boolean, required — Indicates if spend control is active
  - `last_modified_time` string, date-time, required — The timestamp representing when the spend control was last modified
  - `merchant_category_codes` string[] — merchant category codes for spend control
  - `name` string, required — Name assigned to spend control
  - `payment_sub_types` string[] — A list of payment sub-types to which a spend control will apply, if set. If not set or the array is empty, then the spend control will apply to all sub-types.
  - `payment_types` PaymentType[] — A list of payment types to which a spend control will apply, if set. If not set or the array is empty, then the spend control will apply to all types of payments.
  - `scope` 'ACCOUNT' | 'BANK' | 'FINTECH', required — The scope of the spend control
  - `time_range` union, required — The time range to which the spend control applies
    - SpendControlTimeRangeType
      - `time_range_type` 'FOREVER' | 'ROLLING_WINDOW_DAYS' | 'SINGLE_TRANSACTION', required
    - SpendControlTimeRangeType
      - `time_range_type` 'FOREVER' | 'ROLLING_WINDOW_DAYS' | 'SINGLE_TRANSACTION', required
    - object
      - `days` integer, required — The number of days to define a rolling window for a spend control
      - `time_range_type` 'FOREVER' | 'ROLLING_WINDOW_DAYS' | 'SINGLE_TRANSACTION', required

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `422` — Unprocessable entity request response
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/versions/b0d812e6cdd0/schema)