---
title: "GET /v1/app-gateway/{appId}/workflows/{workflowId}/runs"
method: GET
path: "/v1/app-gateway/{appId}/workflows/{workflowId}/runs"
---

# GET /v1/app-gateway/{appId}/workflows/{workflowId}/runs

`GET /v1/app-gateway/{appId}/workflows/{workflowId}/runs`

List runs for a deep-agent app's workflow

## Path parameters

- `appId` string, required
- `workflowId` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- AppGatewayRunsSuccessResponse
  - `code` integer
  - `data` PaginatedDataRunListItem
    - `hasMore` boolean
    - `items` RunListItem[]
      - `finishedAt` string
      - `id` string
      - `isDustTest` boolean
      - `isSimulation` boolean
      - `sourceRunId` string
      - `startedAt` string
      - `status` 'running' | 'waiting' | 'success' | 'partial' | 'failure' | 'cancelled'
      - `summary` string
      - `totalCu` number
      - `triggerNodeId` string
      - `triggerSource` string
      - `triggeredBy` string
      - `workflowId` string
      - `workflowName` string
      - `workflowVersion` integer
    - `limit` integer
    - `offset` integer
  - `message` string
  - `requestId` string

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.dev/b3os/apis/b3os-workflow-api.md) · [All operations](https://skmtc.dev/b3os/apis/b3os-workflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/b3os/b3os-workflow-api/revisions/a8c7af3c66a1/schema)