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

# ManageBotChannelAccess

> Grant or revoke a manageable bot's access to one channel.

# ManageBotChannelAccess

Grant or revoke a manageable bot's access to one channel. Granting requires the current user to be a channel member. Both actions require the user to own the bot or belong to its owning team; revoking still works after the manager leaves the channel. Granting access creates that channel's webhook URL; revoking access disables posting to that channel. Use only after the user asks to change bot access.

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `botId` | string | Yes | Bot id from CreateBot or ListBots. |
| `channelId` | string | Yes | Channel id to grant or revoke access to. |
| `action` | `"grant"` \| `"revoke"` | Yes | Channel-access change to apply to a bot. |


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