# channels

> Connected channels: WhatsApp, Instagram, Messenger, Pages, Threads, voice numbers.

Connected channels: WhatsApp, Instagram, Messenger, Pages, Threads, voice numbers.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/channels` | `channels_list`: List channels | `channels:read` | yes |
| DELETE | `/v1/channels/{channel_id}` | `channels_disconnect`: Disconnect a channel | `channels:write` | - |
| GET | `/v1/channels/{channel_id}` | `channels_get`: Get a channel | `channels:read` | yes |
| PATCH | `/v1/channels/{channel_id}` | `channels_update`: Update channel settings | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/block-list` | `channels_block_list`: Blocked users | `channels:read` | - |
| POST | `/v1/channels/{channel_id}/block-list` | `channels_block_users`: Block users on WhatsApp | `channels:write` | - |
| DELETE | `/v1/channels/{channel_id}/block-list/{contact_id}` | `channels_unblock_user`: Unblock a user | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/call-settings` | `channels_call_settings_get`: WhatsApp Calling settings | `calls:read` | - |
| PUT | `/v1/channels/{channel_id}/call-settings` | `channels_call_settings_put`: Update WhatsApp Calling settings | `calls:write` | - |
| GET | `/v1/channels/{channel_id}/capabilities` | `channels_capabilities_get`: Connector capabilities | `channels:read` | - |
| GET | `/v1/channels/{channel_id}/coexistence` | `channels_coexistence_get`: Coexistence sync state | `channels:read` | - |
| POST | `/v1/channels/{channel_id}/coexistence/restart` | `channels_coexistence_restart`: Restart the coexistence sync | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/health` | `channels_health_get`: Channel health | `channels:read` | - |
| POST | `/v1/channels/{channel_id}/health/refresh` | `channels_health_refresh`: Re-check health against Meta | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/ice-breakers` | `channels_ice_breakers_get`: Ice breakers / conversation starters | `channels:read` | - |
| PUT | `/v1/channels/{channel_id}/ice-breakers` | `channels_ice_breakers_put`: Set ice breakers | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/levels` | `channels_levels_get`: Connection levels | `channels:read` | - |
| GET | `/v1/channels/{channel_id}/limits` | `channels_limits_get`: Messaging limits and throughput | `channels:read` | - |
| GET | `/v1/channels/{channel_id}/payment-status` | `channels_payment_status_get`: Meta payment-method health | `channels:read` | - |
| POST | `/v1/channels/{channel_id}/private-lane/release` | `channels_private_lane_release`: Mark synced chats as business (owner only) | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/profile` | `channels_profile_get`: WhatsApp business profile | `channels:read` | - |
| PATCH | `/v1/channels/{channel_id}/profile` | `channels_profile_update`: Update the WhatsApp business profile on Meta | `channels:write` | - |
| POST | `/v1/channels/{channel_id}/reconnect` | `channels_reconnect`: Re-authenticate a channel | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/routing` | `channels_routing_get`: Routing / standby state | `channels:read` | - |
| PUT | `/v1/channels/{channel_id}/routing` | `channels_routing_put`: Set FAQ mode and in-app AI declaration | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/usernames` | `channels_username_get`: WhatsApp business username | `channels:read` | - |
| POST | `/v1/channels/{channel_id}/usernames` | `channels_username_claim`: Claim or change the business username | `channels:write` | - |
| GET | `/v1/channels/available-services` | `channels_available_services`: What each channel type can do on this plan | `channels:read` | - |
| POST | `/v1/channels/connect-sessions` | `channels_connect_session_create`: Start connecting a channel | `channels:write` | - |
| GET | `/v1/channels/connect-sessions/{id}` | `channels_connect_session_get`: Poll connect progress | `channels:write` | - |
| POST | `/v1/channels/connect-sessions/{id}/callback` | `channels_connect_session_callback`: Finalise a connection | `channels:write` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
