# Audit Channels

## List audit channels <a href="#list-audit-channels" id="list-audit-channels"></a>

### Basic list <a href="#basic-list" id="basic-list"></a>

```bash
lenses-cli auditchannels
```

### Detailed view <a href="#detailed-view" id="detailed-view"></a>

```bash
lenses-cli auditchannels --details
```

### List audit channels with possible flags <a href="#list-audit-channels-with-possible-flags" id="list-audit-channels-with-possible-flags"></a>

```bash
lenses-cli auditchannels \
--page=1 \
--pageSize=10 \
--sortField="name" \
--sortOrder="asc" \
--templateName="test" \
--channelName="slack"
```

## List audit channel templates <a href="#list-audit-channel-templates" id="list-audit-channel-templates"></a>

When creating audit channels, one of the existing predefined channel templates needs to be used.

Such a command lists all available audit channel templates:

```bash
lenses-cli auditchannel-templates
```

To get all the details, use JSON format:

```bash
lenses-cli auditchannel-templates --output JSON
```

## Create a new audit channel <a href="#create-new-audit-channel" id="create-new-audit-channel"></a>

```bash
lenses-cli auditchannels create \
  --name "my-audit-channel-1" \
  --connectionName="w1" \
  --templateName="Webhook" \
  --properties="[{\"key\":\"body\",\"value\":\"payload1-created\"},{\"key\":\"insecure\",\"value\":true},{\"key\":\"method\",\"value\":\"GET\"}]"
```

Create a new audit channel using a YAML file:

```yaml
name: "my-audit-channel-2"
templateName: "Webhook"
connectionName: "w1"
properties:
  - key: "body"
    value: "body-payload"
  - key: "insecure"
    value: true
  - key: "method"
    value: "GET"
```

\
Save the file as audit\_chann.yml and execute it like this:Copy

```bash
lenses-cli auditchannels create audit_chann.yml
```

## Update an audit channel <a href="#update-an-audit-channel" id="update-an-audit-channel"></a>

```bash
lenses-cli auditchannels update \
  --id "ID_OF_THE_CHANNEL_TO_BE_UPDATED" \
  --name "my-audit-channel-2-updated" \
  --connectionName="w1" \
  --templateName="Webhook" \
  --properties="[{\"key\":\"body\",\"value\":\"payload1-created\"},{\"key\":\"insecure\",\"value\":true},{\"key\":\"method\",\"value\":\"GET\"}]"
```

## Delete an audit channel <a href="#delete-an-audit-channel" id="delete-an-audit-channel"></a>

```bash
lenses-cli auditchannels delete \
    --channelID="701ff62c-8d14-4ef9-8dd0-fe2cd3c73779"
```