---
title: "A durable workflow with its event log (owner-scoped)"
method: GET
path: "/assistant/workflows/{workflowId}"
tags: ["Assistant"]
---

# A durable workflow with its event log (owner-scoped)

`GET /assistant/workflows/{workflowId}`

## Path parameters

- `workflowId` string, required

## Response `200`

The workflow summary and its events, oldest first

- AssistantWorkflowDetailResponse
  - `data` object, required
    - `events` object[], required
      - `actor` string — model, job, user or ui
      - `createdAt` string, date-time
      - `delta` object
      - `fromStep` string
      - `seq` integer
      - `signal` string — tool:<name>:<callId>, job:<id>:<status>, user:apply:<proposalId>, user:dismiss:<proposalId>, user:cancel:<id> or ui:<event>:<ref>
      - `toStep` string
    - `workflow` AssistantWorkflowSummary, required
      - `id` string, required
      - `kind` string, required — document_emissions, bom_footprint or supplier_research
      - `status` string, required — active, waiting_job, waiting_user, completed, failed or cancelled
      - `step` string, required — document_emissions: UPLOADED, EXTRACTING, ROWS_READY, NEEDS_REVIEW, SUBMITTED, EXTRACTION_FAILED, CANCELLED. bom_footprint: SCANNED, IMPORTING, LINES_READY, FOOTPRINT_READY, NEEDS_REVIEW, SAVED, IMPORT_FAILED, CANCELLED. supplier_research: RESEARCHING, RESEARCHED, RESEARCH_FAILED. EXTRACTING and IMPORTING also cover a re-run started on the review page (waitingFor ui_action); CANCELLED is a record deleted on its page.
      - `stepCount` integer, required
      - `stepIndex` integer, required
      - `stepLabel` string, required
      - `title` string, required
      - `updatedAt` string, date-time, required
      - `waitingFor` object, nullable
        - `kind` string — job, user_confirm or ui_action
        - `ref` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-10-01** `b4751fd15397` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/assistant/workflows/:workflowId/get.md)

---

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