# Report Channels

> List chat channels available for report_channels when authoring forms and check-ins.

Language: en
Canonical: https://www.dailybot.com/developers/api/report-channels
Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.
Last Updated: 2026-07-06

---

# Report channels

Discover chat channels available for `report_channels` when creating or configuring forms and check-ins. Channel IDs from this endpoint feed authoring payloads (max 3 per resource).

Authentication: `X-API-KEY` header or `Authorization: Bearer <cli_token>` with read capability.

## Endpoints summary

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/report-channels/` | List available report channels |

---

## GET /v1/report-channels/

Returns chat channels (Slack, Microsoft Teams, Discord, Google Chat) available for `report_channels` on forms and check-ins. Use channel `id` values when creating or editing.

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `name` | string | No | Prefix filter by channel name. |
| `limit` | integer | No | Maximum number of channels to return. |

```bash
curl -sS 'https://api.dailybot.com/v1/report-channels/?name=general' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

**Response (200 OK):**

```json
{
  "channels": [
    {
      "id": "channel-uuid",
      "name": "general",
      "platform": "slack"
    }
  ],
  "total": 1
}
```

**Response (401 Unauthorized):** Missing or invalid credential.

**Response (403 Forbidden):** Insufficient permissions.

**Response (429 Too Many Requests):** Rate limited — `Retry-After` header is set.

### CLI equivalent

```bash
dailybot channels list
```

### Notes

- Maximum 3 report channels per form or check-in.
- Channel IDs must exist in this list when setting `report_channels` on create or config patch payloads.

## Endpoints in this group

Discover chat channels available for `report_channels` when creating or configuring forms and check-ins. Channel IDs from this endpoint feed authoring payloads (max 3 per resource).

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/report-channels/` | List available report channels |

### GET `/v1/report-channels/`

**List available report channels**

Returns chat channels (Slack, Teams, Discord, Google Chat) available for report_channels on forms and check-ins. Use channel id values when creating or editing.

- **Auth:** API key (`X-API-KEY`), CLI Bearer (read)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `name` | string | No | Prefix filter by channel name |
| `limit` | integer | No | Max channels to return |

#### Response body

```json
{
  "channels": "array",
  "total": "integer"
}
```

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing or invalid credential |
| `403` | Insufficient permissions (admin/manager required for write) |
| `429` | Rate limited — Retry-After header set |

#### Example (curl)

```bash
curl -sS 'https://api.dailybot.com/v1/report-channels/?name=general' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

#### Notes

- CLI: dailybot channels list. Max 3 report channels per form/check-in.

---

## Developer portal navigation

**Getting Started**

- [Overview](/developers)
- [Quick start](/developers/getting-started)
- [Authentication](/developers/authentication)

**API Reference**

- [API Overview](/developers/api)
- [Users](/developers/api/users)
- [Organization](/developers/api/organization)
- [Teams](/developers/api/teams)
- [Invitations](/developers/api/invitations)
- [Check-ins](/developers/api/check-ins)
- [Forms](/developers/api/forms)
- [Report channels](/developers/api/report-channels) (this page)
- [Templates](/developers/api/templates)
- [Kudos](/developers/api/kudos)
- [Mood tracking](/developers/api/mood)
- [Important dates](/developers/api/important-dates)
- [Messaging](/developers/api/messaging)
- [Automations](/developers/api/workflows)
- [Webhooks](/developers/api/webhooks)
- [Commands platform](/developers/api/commands-platform)
- [Agents](/developers/api/agents)
- [OAuth2](/developers/api/oauth2)
- [Integrations](/developers/api/integrations)
- [CLI](/developers/api/cli)

**API guides**

- [Errors & Status Codes](/developers/errors)
- [Rate Limits](/developers/rate-limits)
- [Conventions](/developers/conventions)
- [API Changelog](/developers/api-changelog)
- [Recipes](/developers/recipes)

**Developer Features**

- [Custom commands](/developers/custom-commands)
- [Serverless commands](/developers/serverless)
- [Webhooks & events](/developers/webhooks)
- [Automation API trigger](/developers/workflow-trigger)
- [Activity API](/developers/activity-api)

**CLI**

- [Overview](/developers/cli)
- [Authentication](/developers/cli-authentication)
- [Command reference](/developers/cli-reference)
- [CI/CD recipes](/developers/cli-ci-cd)
- [Configuration](/developers/cli-configuration)
- [Troubleshooting](/developers/cli-troubleshooting)

**Agent Skill**

- [Overview](/developers/agent-skill)
- [Skills catalog](/skills)

---

## Site navigation

**Product:**
- [Home](/)
- [Product](/product)
- [Pricing](/pricing)
- [Enterprise](/enterprise)
- [Integrations](/integrations)
- [Templates](/templates)

**Resources:**
- [Blog](/blog)
- [Academy](/academy)
- [Changelog](/changelog)
- [Help Center](/help)
- [Developers](/developers)
- [Agents](/agents)

**Company:**
- [About](/about)
- [Careers](/careers)
- [Security](/security)
- [Contact Sales](/demo)

**Connect:**
- [LinkedIn](https://www.linkedin.com/company/dailybot/)
- [X/Twitter](https://twitter.com/dailybot)
- [GitHub](https://github.com/Dailybot-Inc)
- [YouTube](https://www.youtube.com/channel/UC3uM9V52vwX7e3vQpCc4qvA)