---
title: "List the workspace's channel triggers"
method: GET
path: "/v1/channel-feeds"
tags: ["channel-feeds"]
---

# List the workspace's channel triggers

`GET /v1/channel-feeds`

## 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/channel-feeds`
- Auth: HTTP bearer

List active triggers by default, stopped triggers, or all visible triggers.

## Query parameters

- `status` 'active' | 'stopped' | 'all'

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- TriggerListResponse: The triggers in the caller's selected status view.
  - `items` TriggerView[], required
    - `id` string, uuid, required
    - `action` 'announce' | 'agent', required
    - `status` 'active' | 'stopped', required
    - `source` string, required
    - `source_label` string, required
    - `source_connected` boolean, nullable
    - `event` string, required
    - `event_label` string, required
    - `narrowing` TriggerNarrowing[], required
      - `field` string, required
      - `label` string, required
      - `kind` string, required
      - `value` string, required
      - `display_value` string, required
    - `instruction` string, nullable, required
    - `template` string, required
    - `channel_name` string, nullable, required
    - `channel_external_id` string, required
    - `platform_code` string, required
    - `armed_by` string, nullable, required
    - `runs_as_caller` boolean, required
    - `armed_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `total_fires` integer, required
    - `last_fired_at` string, date-time, nullable, required
    - `failed_fires` integer, required
    - `last_failed_at` string, date-time, nullable, required

## 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)