---
title: "Get Style Agent Workflow"
method: GET
path: "/style-agent/workflows/{workflow_id}"
tags: ["styleAgent"]
---

# Get Style Agent Workflow

`GET /style-agent/workflows/{workflow_id}`

Get the status and result of a Style Agent content-check run.

Poll with the workflow id returned by ``POST /style-agent/run``. While the
run is in progress the status reflects its state; once it completes the
response includes the result.

## Path parameters

- `workflow_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- StyleAgentWorkflowStatusResponse — Status of a Style Agent content-check run, with the result envelope typed so the ``analysis`` naming contract is part of the published schema.
  - `workflow_id` string, required — Workflow ID
  - `agent_id` string — Agent that ran this workflow
  - `document_ref` string, nullable — Caller-provided document identifier.
  - `status` 'running' | 'completed' | 'failed' | 'timed_out' | 'cancelled', required — Status of a workflow execution.
  - `result` StyleAgentResult — Result of a Style Agent content check. Only the ``analysis`` block is typed here — issues, quality scores, and any agent-specific keys flow through unchanged (``extra="allow"``). Validating ``analysis`` at this edge also mirrors the legacy ``targetId`` naming onto the canonical ``styleGuideId`` keys for results persisted before the rename.
    - `analysis` StyleAgentAnalysis — Style guide, content profile, and readability metadata forwarded from SLS. Cortex populates this from the language-service ``data.analysis`` block (legacy ``targetId`` naming) and helios_one republishes it on the style-agent API surface. ``styleGuideId`` / ``styleGuideDisplayName`` are the canonical public keys; the legacy ``targetId`` / ``targetDisplayName`` keys carry the same values (and are marked deprecated in the schema) until removed in a future API version. The mirror runs on validation, so results persisted before the rename gain the canonical keys when re-validated.
      - `styleGuideId` string, nullable
      - `styleGuideDisplayName` string, nullable
      - `targetId` string, nullable
      - `targetDisplayName` string, nullable
      - `contentProfileId` string, nullable
      - `contentProfileDisplayName` string, nullable
      - `words` integer, nullable
      - `sentences` integer, nullable
      - `clarityIndex` number, double, nullable
      - `informalityIndex` number, double, nullable
      - `livelinessIndex` number, double, nullable
      - `fleschReadingEase` number, double, nullable
  - `started_at` string, date-time, required — Start time
  - `completed_at` string, date-time, nullable — Workflow completion time

## Other responses

- `401` — Authentication failed or no valid API key provided.
- `403` — Forbidden
- `404` — Workflow not found
- `422` — Validation Error
- `500` — Failed to retrieve workflow status

---

[API](https://skmtc.net/markup/apis/api-reference.md) · [All operations](https://skmtc.net/markup/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/markup/api-reference/revisions/8e28e770c55d/schema)