---
title: "List deliverable channels"
method: GET
path: "/v1/cron-jobs/deliverable-channels"
tags: ["cron-jobs"]
---

# List deliverable channels

`GET /v1/cron-jobs/deliverable-channels`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/cron-jobs/deliverable-channels`
- Auth: HTTP bearer

List channels available to the scheduled-delivery picker, from the caller's own chat platform when the workspace has installed it, and otherwise from the workspace's first installed platform.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

The caller's best-effort channel choices.

- DeliverableChannelsResponse: Best-effort channel choices for the dashboard delivery picker.
  - `items` DeliverableChannel[], required
    - `external_id` string, required
    - `name` string, required
    - `is_private` boolean, required
  - `opens_threads` boolean: Whether a post in one of these channels opens a thread on this chat app. False when the workspace has no chat app to list channels from.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `422`: Validation error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)