# Channel instance

A channel instance holds a connection configuration and credential reference for a specific Provider. The provider and channel type together determine the available fields for `config` and `secrets` when creating, updating, and testing.

## Choose a task

| Task | Description |
| --- | --- |
| [View channel instance list](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/channel-instances/list-channel-instances.html.md) | Lists channel instances in the current workspace by Provider. |
| [View channel instance details](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/channel-instances/get-channel-instance.html.md) | Read non-sensitive configuration, capabilities, and recent test information for a channel instance. |
| [Add channel instance](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/channel-instances/create-channel-instance.html.md) | Creates a channel instance for the specified Provider. |
| [Change channel instance](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/channel-instances/update-channel-instance.html.md) | Partially updates an already created channel instance. |
| [Remove channel instance](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/channel-instances/delete-channel-instance.html.md) | Delete a channel instance and its associated credentials. |
| [Test unsaved channel configuration](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/channel-instances/test-new-channel-configuration.html.md) | Validate an unsaved wecom_mail configuration for the wecom provider without creating an instance. |
| [Test the created channel instance](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/channel-instances/test-channel-instance.html.md) | Verify the current credentials and connection configuration of the saved channel instance. |