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

# Atualizar assinatura

> Altere, pause, retome ou mova uma assinatura de Bandwidth automático

## Atualizar assinatura

Altera as configurações de uma assinatura, pausa-a ou retoma-a, ou a move para outro endereço. Envie apenas os campos que quiser alterar; os demais ficam como estão. As alterações valem na hora: verificamos a assinatura de novo após cada edição. Exige o escopo `buy_bandwidth`.

### Parâmetros de caminho

**sub\_id** `number` *required*

ID da assinatura — o `id` de Criar ou Listar assinaturas

### Corpo da requisição

**enabled** `boolean`

`false` pausa a assinatura: retiramos a largura de banda e não cobramos nada até você retomá-la. `true` retoma uma assinatura pausada ou parada; o seu saldo deve cobrir 24 horas e uma transferência, como ao criar. Uma assinatura desligada pelo suporte (`stopped_reason: "admin"`) não pode ser retomada assim.

**volume** `number`

Nova quantidade de largura de banda. De 1 a 5.000. Aumentá-la dentro de um dia pago cobra a diferença pelo restante do dia.

**address** `string`

Mover a assinatura para outro endereço. Retiramos a largura de banda do endereço antigo e depois delegamos ao novo; `address_change_to` mostra a mudança até ela terminar. O novo endereço passa pelas mesmas verificações da criação. Enviar o endereço atual cancela uma mudança que não terminou.

**token** `string`

`"USDT"`, `"TRX"`, `"USDD"`, `"CUSTOM"` ou `"OWN"`. Mudar para `USDT`, `TRX` ou `USDD` remove o `contract`.

**contract** `string | null`

Um contrato da [sua lista de tokens](https://docs.tronrental.com/pt/api-reference/auto-bandwidth/list-contracts.md), para `CUSTOM` ou `OWN`. `null` o remove (não é possível com `CUSTOM`).

**label** `string | null`

Novo nome, até 50 caracteres. `null` ou uma string vazia o remove.

**auto\_pause** `boolean`

Liga ou desliga a pausa automática.

**threshold** `number`

Novo nível de largura de banda gratuita, com o mesmo intervalo da criação.

**notify\_free\_bw** `boolean`

Liga ou desliga a notificação de largura de banda gratuita.

**stop\_after\_transfer** `boolean`

`true` pausa a assinatura após a próxima transferência do seu token, contada a partir de agora. `false` cancela isso.

### Resposta

A assinatura atualizada, com os mesmos campos de [Listar assinaturas](https://docs.tronrental.com/pt/api-reference/auto-bandwidth/list-subscriptions.md).

### Exemplo

Pausar uma assinatura:

```bash cURL theme={null}
curl -X PATCH https://api.tronrental.com/v1/bandwidth/auto/42 \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'
```

```python Python theme={null}
import requests

resp = requests.patch(
    "https://api.tronrental.com/v1/bandwidth/auto/42",
    headers={"X-API-Key": "your_api_key"},
    json={"enabled": False},
)
print(resp.json())
```

```javascript JavaScript theme={null}
const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto/42", {
  method: "PATCH",
  headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" },
  body: JSON.stringify({ enabled: false }),
});
console.log(await resp.json());
```

```json Response theme={null}
{
  "id": 42,
  "address": "TYourSenderAddress12345678901234ab",
  "label": "Payouts",
  "token": "USDT",
  "contract": null,
  "volume": 350,
  "auto_pause": false,
  "threshold": 600,
  "stop_after_transfer": false,
  "notify_free_bw": false,
  "status": "paused",
  "stopped_reason": null,
  "address_change_to": null,
  "free_bw": 330,
  "delegated_bw": 350,
  "transfers": 12,
  "delivery_state": "ok",
  "paid_until": "2026-11-14T08:15:04Z",
  "total_charged_trx": "5.100000",
  "daily_trx": "0.340000",
  "transfer_trx": "0.340000",
  "transfer_bw_trx": "0.140000",
  "transfer_fee_trx": "0.200000",
  "created_at": "2026-11-10T08:15:00Z"
}
```

`delegated_bw` cai para `0` assim que a largura de banda é retirada, em poucos segundos.

### Erros

| Status | Código | Quando |
| - | - | - |
| `400` | `INVALID_ADDRESS` | O novo `address` não é um endereço TRON válido, ou não foi possível conectá-lo |
| `400` | `CONTRACT_ADDRESS_NOT_SUPPORTED` | O novo `address` é um contrato inteligente |
| `400` | `AUTO_BW_INVALID_THRESHOLD` | `threshold` está fora do intervalo permitido para o `volume` |
| `400` | `AUTO_BW_INVALID_CONTRACT` | `CUSTOM` sem contrato, um contrato com outro token, ou um contrato que não está na sua lista de tokens |
| `402` | `INSUFFICIENT_BALANCE` | Ao retomar, o saldo não cobre 24 horas e uma transferência |
| `403` | `FORBIDDEN` | A chave de API não tem o escopo `buy_bandwidth` |
| `404` | `NOT_FOUND` | Não existe assinatura com este ID na sua conta (ou ela foi excluída) |
| `409` | `AUTO_BW_ADDRESS_TAKEN` | Outra das suas assinaturas já usa o novo endereço |
| `409` | `AUTO_BW_ADDRESS_COVERED` | A largura de banda do novo endereço já é mantida pelo Smart Mode ou por um pacote de transferências |
| `409` | `AUTO_BW_CONTRACT_LISTED` | `contract` é o contrato do USDT ou do USDD — use `token` |
| `409` | `AUTO_BW_DISABLED_BY_SUPPORT` | A assinatura foi desligada pelo suporte — entre em contato conosco para retomá-la |
| `422` | — | Um campo tem o tipo errado ou está fora do intervalo |
| `429` | `RATE_LIMIT_EXCEEDED` | Requisições de edição demais — veja [Limites de Taxa](https://docs.tronrental.com/pt/resources/rate-limits.md) |
| `503` | `AUTO_BW_DISABLED` | `enabled: true` enquanto o Bandwidth automático está temporariamente desligado; nada foi alterado — tente novamente mais tarde |


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