---
title: "Update automatic recurrence"
method: PATCH
path: "/inst-pull-pay/v1/pix/automatic/{recurrence_id}"
tags: ["Automatic Pix"]
---

# Update automatic recurrence

`PATCH /inst-pull-pay/v1/pix/automatic/{recurrence_id}`

Update automatic recurrence.

## Path parameters

- `recurrence_id` string, required

## Headers

- `Authorization` string, required
- `x-account-id` integer, required

## Request body

- PatchRecurrenceRequest — Payload with available fields to update a recurrence.
  - `max_payment_amount` number — Payer-defined maximum payment amount for dynamic amount recurrences.
  - `taxes` TaxesWithCategory — Now only available on ext env and just for direct parciapants. Tax information related to the transaction.
    - `tax_identifier` string — Tax identifier, referring to the NFe, NFSe or aggregating tax document. In Brazil, NF-e and NFS-e are the two primary types of mandatory electronic invoices (Notas Fiscais) used for tax compliance. * NF-e (Nota Fiscal Eletrônica): Used for the sale and movement of physical goods or products. It is regulated at the state level by SEFAZ (SEFAZ (Secretaria da Fazenda) is the State Department of Finance in Brazil.) and travels with the goods. * NFS-e (Nota Fiscal de Serviços Eletrônica): Used for the provision of services (e.g., consulting, repairs, digital subscriptions). It is regulated by individual city governments. The value entered must correspond to the tax document used for calculating the IBS and CBS taxes associated with the transaction.
    - `records` RecordsWithCategory[] — Tax records. It is **REQUIRED** to pass a minimum of 2 objects and a maximum of 4 objects, at least one with `CBS` tax type and at least one with `IBS` tax type.
      - `tax_type` 'CBS' | 'IBS' — Tax type: `IBS` = Goods and services tax. A state and municipal tax that unifies and replaces the main subnational consumption taxes (state ICMS and municipal ISS). `CBS` = Contribution on goods and services. A federal tax that consolidates and replaces previous federal social contributions and taxes (PIS, Cofins, and IPI).
      - `tax_category` 'INF' | 'COR' — Tax category: * `INF` (Conta e Ordem) = Tax information * `COR` (Informar no momento da emissão)) = Corrected tax
      - `amount` number — Tax amount. Must be greater than zero.

## Response `204`

No Content

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)