# Updating channel

<mark style="color:green;">`PATCH`</mark> `/api/public/v1/channels/:id/status`

This endpoints updates channel status.

**Headers**

| Name          | Value                      |
| ------------- | -------------------------- |
| Content-Type  | `application/vnd.api+json` |
| Authorization | `Bearer <api_key>`         |

**Path Parameters**

| Name | Type   | Description |
| ---- | ------ | ----------- |
| id   | string | Channel ID. |

**Body**

| Name                   | Type   | Description                            |
| ---------------------- | ------ | -------------------------------------- |
| data.type              | string | Aways `channels`.                      |
| data.attributes.status | string | Can be either `enabled` or `disabled`. |

**Response**

{% tabs %}
{% tab title="HTTP 201" %}

```json
{
  "data": {
    "id": "60e05bc0-4690-4985-a08a-8acf00e48294",
    "type": "channels",
    "attributes": {
      "reference": "ecd05fb9-76e6-42e7-b86e-5a7e18f4da6d",
      "status": "disabled",
      "createdAt": "2024-09-25T08:35:07.034Z",
      "updatedAt": "2024-09-25T09:31:21.958Z",
      "payCurrency": "USDT",
      "targetCurrency": "USD",
      "targetAccountId": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "address": "TJTuEYJ8P9to4Zhdw7zg55VPH3gzLaQDV6",
      "networkName": "Tron (TRC20)",
      "networkCode": "ttrx:usdt",
      "hostedPageUrl": "https://sandbox.txn.pro/redirect?channel_id=60e05bc0-4690-4985-a08a-8acf00e48294\u0026request_type=channel_hosted_page\u0026zone=eu"
    }
  },
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}
```

{% endtab %}

{% tab title="HTTP 404" %}

```json
{
  "errors": [
    {
      "status": 404,
      "title": "Record not found",
      "code": "channel_not_found"
    }
  ]
}
```

{% endtab %}
{% endtabs %}

**Response Body**

| Name                            | Type   | Description                                                                                                                                                                                                          |
| ------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| data.id                         | string | Channel ID.                                                                                                                                                                                                          |
| data.type                       | string | Always `channels`.                                                                                                                                                                                                   |
| data.attributes.targetCurrency  | string | Specifies the merchant’s currency account on the txn platform, i.e. the account to which the deposit will be credited. Refer to [supported](https://docs.txn.pro/api-basics/supported-currencies) currencies.        |
| data.attributes.targetAccountId | string | Specifies the target account ID.                                                                                                                                                                                     |
| data.attributes.localCurrency   | string | Currency to display to end users, e.g. their local currency in which they hold a balance on the merchant’s platform. This field is optional and can be different from the `targetCurrency` value.                    |
| data.attributes.payCurrency     | string | Crypto currency that customer must pay in. Refer to [supported](https://docs.txn.io/api-basics/supported-currencies) currencies.                                                                                     |
| data.attributes.address         | string | Channel address.                                                                                                                                                                                                     |
| data.attributes.networkCode     | string | Payment network code. Refer to [supported](https://docs.txn.pro/api-basics/supported-currencies) networks.                                                                                                           |
| data.attributes.networkName     | string | Network name.                                                                                                                                                                                                        |
| data.attributes.hostedPageUrl   | sting  | Channel redirect URL hosted by Txn.                                                                                                                                                                                  |
| data.attributes.reference       | string | The custom reference ID to tie the channel and its deposits to end-user who pays.                                                                                                                                    |
| data.attributes.status          | string | Channel status. Can be either `enabled` or `disabled`. If `enabled`, deposits get processed and credited to the merchant's account as normal. If `disabled`, deposits do not get credited to the merchant's account. |
| data.attributes.createdAt       | string | Timestamp when a channel was created.                                                                                                                                                                                |
| data.attributes.updatedAt       | string | Timestamp when a channel was last updated.                                                                                                                                                                           |