# listWorkflows

List the organization's workflow automations (paginated, non-archived by default). Returns the group id to use in getWorkflow and the other workflow operations. `status`, `domain`, `name` (a name search, any case) and `triggerType` (on a version of that status; hidden groups included) narrow rows and `total`. For a workflow the person named, pass their words as `name` and compare each row's `name` for the exact one, reading every page `total` counts before calling one row the only exact match (names are not unique). Each row carries `channelsAcrossVersions`: the channels the workflow messages on (TEXT, EMAIL, both, or [] when it messages nobody; never null), the same answer the app's Channel filter gives, so read it to PICK workflows out of a list. It spans EVERY version not deleted: the published one, the ones it superseded and an unpublished draft. getWorkflow.`channels` reads ONE: the most recently PUBLISHED version whatever its status (active, paused or suspended), else the pending draft. NEITHER says it is SENDING: a paused or suspended head keeps its configured channels while sending nothing. Read `status` for that.

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "listWorkflows", "variables": {...} }`
- Scope: `READ`
- Type: query
- Idempotency: a read; rejects `Idempotency-Key`
- Rate-limited: no
- Result cap: `limit` is clamped to 50, without an error

## Variables

- `limit`: `Int` (default `20`)
- `offset`: `Int` (default `0`)
- `status`: `WorkflowGroupStatus` (one of `DRAFT`, `ACTIVE`, `PAUSED`, `SUSPENDED`)
- `domain`: `WorkflowDomain` (one of `PROPERTY`, `CONTACT`, `PIPELINE_ITEM`, `DEAL`, `APPOINTMENT`, `EVENT`, `SLACK`, `CONTRACT`)
- `name`: `String`
- `triggerType`: `[WorkflowTriggerType!]` (one of `MUTATION`, `MATCH`, `CREATED`, `MANUAL`, `INBOUND_TEXT`, `INBOUND_EMAIL`, `INBOUND_CALL`, `EVENT_RECEIVED`, `SLACK_MESSAGE_RECEIVED`, `RECORD_EVENT`, `COMMUNICATION`, `CONTRACT_EVENT`)

## Response (data, an example)

```json
{
  "workflowAutomationsQuery": {
    "workflowGroupsPage": {
      "items": [
        {
          "id": "<ID>",
          "name": "…",
          "description": "…",
          "status": "DRAFT",
          "channelsAcrossVersions": [
            "TEXT"
          ],
          "workflowDomain": "PROPERTY",
          "systemCategory": "…",
          "folderId": "<ID>",
          "createdAt": "2026-01-01T00:00:00.000Z",
          "updatedAt": "2026-01-01T00:00:00.000Z",
          "archivedAt": "2026-01-01T00:00:00.000Z"
        }
      ],
      "total": 0
    }
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operationId": "listWorkflows",
    "variables": {}
  }'
```