---
id: workflow-revision-list
title: "List revisions"
description: "Lists the workflow's revisions, paginated. Definitions are omitted (`definition: null`) unless `includeDefinition=true`."
sidebar_label: "List revisions"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/workflows
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List revisions"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/workflows/definitions/{id}/revisions"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists the workflow's revisions, paginated. Definitions are omitted (`definition: null`) unless `includeDefinition=true`.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Workflow reference: a server-minted id (`wf_...`) or the workflow's client-chosen key (lowercase slug, unique per organization).","example":"wf_ifWBbWfpug0n"},{"in":"query","name":"includeDefinition","schema":{"type":"boolean","default":false},"description":"Include each revision's full definition."},{"in":"query","name":"limit","schema":{"type":"integer","default":50,"maximum":500},"description":"The maximum number of results per page (clamped to 500).","example":50},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination.","example":0}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The paginated list of revisions.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"title":"Revision","type":"object","required":["workflowId","revision","createdAt"],"properties":{"workflowId":{"type":"string","example":"wf_ifWBbWfpug0n"},"revision":{"type":"integer","description":"Revision number, starting at 1.","example":3},"definition":{"type":"object","nullable":true,"description":"The full definition. `null` in list responses unless `includeDefinition=true`."},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"string"},"releaseNotes":{"type":"string"},"semanticVersion":{"type":"string"}}}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}},"4XX":{"description":"Client error. The body says what went wrong: an error `type`, a human-readable `detail`, and, on validation failures, one entry per offending field.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}},"5XX":{"description":"Unexpected server error.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}}}}
>
  
</StatusCodes>