---
title: "Alteração de status de modalidade"
method: PATCH
path: "/cards/{proxy}/functionalityStatus"
tags: ["Cartão combo"]
---

# Alteração de status de modalidade

`PATCH /cards/{proxy}/functionalityStatus`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/functionalityStatus`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Realize o bloqueio temporário de uma das modalidade do cartão do tipo combo (débito ou pós) ou habilite uma modalidade que havia sido bloqueada.</p> 
  <span class="bkly-ref-small-beta-tag">beta</span> 
  <span class="bkly-ref-scope-tag">scope: card.update</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Alteração de status de modalidade](/docs/alteracao-status-modalidade)."
}
[/block]

## Path parameters

- `proxy` string, required: Código identificador do cartão.

## Headers

- `api-version` string, required: Versão da API. Atualmente estamos na versão 1.0.
- `Authorization` string, required: <em>Token</em> de autorização do tipo Bearer.

## Request body

- ChangeFunctionalityStatusCommand
  - `enable` boolean, required: Campo que indica se a modalidade deverá ser habilitada (true) ou bloqueada temporariamente (false).
  - `functionalityType` 'Pos' | 'Debit', required
  - `password` string, nullable, required: Senha do cartão. Informe somente números. <b>Importante</b>: dependendo da configuração do programa, o envio deste campo poderá ser opcional.
  - `documentNumber` string, required: Número de documento de CPF ou CNPJ. Informe somente números.

## Response `200`

Status da modalidade alterado com sucesso.

## Other responses

- `400` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-cart-es.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/revisions/1116211d65a0?raw)