---
id: workflow-revision-read
title: "Read a revision"
description: "Returns one revision with its full definition."
sidebar_label: "Read a revision"
hide_title: true
hide_table_of_contents: true
api: eJztWEuP2zYQ/isDXrLZauVtmyKFgR42aVKkhyLYJE2BdFHT4shilyIVzshe1/B/L4aSZXntJG1OOcQX6zEczuObjzPaKNYLUtN36m2It6ULK4i4tGSDJ3WTKYNURNuwDV5N1TVyGz1B8DiIwcpyBZYJytY5MFhab0U+V5kKDUYtNy+MmqpVv8XFbu00ojYqU42OukbGKJZslJW9Gs2VypTXNaqpsiIW8X1rIxo15dhipqiosNZqulG8bkSKOFq/UNv7do98KzGiL3AKGgjjEuNFbT2jAWvgbLYq/8rzfPYQQgSuEHYWPyAonEXPF0UVCD3c4hrOXFhhLDQhkGsXGbTevm8RGowQ4kJ7+0/y/aFEAu903TgxclX+Zcu3T+Zvy6ZdXHq1zU56vIvRf/FbPFhgPHb8dTVKlG/rOUY4awJZtkuEftmhfd9vbzJFWLTR8jqlY446YrxquVLTdzfyOiI1wROS2PDd5aX8fXhjUV8Ez+hZBHXTOFukyEz+JpHejD2ynKJ0vXe/dzLM/8aCD8LxboDUiw4fw5oiomY0VywgbqLgkG1n72jJEXI+nqf9BsehPy6Vg6hnQKwjW78AzfDtvYjL4l3ZjHQPHvvWOT0X2Q4Ax7G+X3swkzUzsB6cJYYhY9B6h0Qws75wrcGfhzU/ie5ZLn7uo3ciQmWItWY1VUYzXrCtcbTkyfpkOUZ0qAl/C9zl4EiAsNaebfE7xnsB3smkX6Ye/fHHMdqeptoEjDHEHCQe82DWQHpNsKo0w0per2Lwiylo3wnCTHaYZaChamvtL4SMJMowM8jaOnnlTQbBw1I7axJkodTWtREpSyyInuO6q/iyRG8kwaVFZz4C+iaGucP6mw+D/2UncQL7x5kn1t7oaHqnkuNn18+fwuMfLx9Dvxd0HlHWkZ4BTTD7kE2zRAiHRdPZcQyGQ3ueJRNEBt5cv8gA80UOs4q5oelkMtA/rYmxzg0uJ8lo2r/ygS/K0HozOyTNz9IhwOpD+rFC/y0wDPLEmls6WeDDikeXj1LJSkg/pXo4Qvpz0sA9XgG8s8Qke1svySw+Ye7gKE32BU+TE3TVBWakTceo10dZexmRpD5O43z6aZxbxppO8dYhhtL59nHXiLGhCRXaT4rgS5u4oUYivfhEVOqWGCq9lGOnOx6g330ND4pg8EFPIYlFfjjFIm883jVYSDPQtQY9oXyt5K+V/LWSv8hKTjq5CjJdLDAZmkz7UGg31mwnw4Az2ewut0paEKn5bgJpoxtBVTc2l3aqcZql+8mLUKtxm/xK6r4LzbhZHrwURarv2+W+E1JZf/F811H9+va12ib4lGHMIrv5hVSmlrsOSV3m3+aXRxh40lpnMmjaubNUZRBbn/oYCPPk4QBjGePSkDN2bQ9y9AvrMf/T/+mfhzaCNahpN9cgcGUJrl6+mIrABZyf7xtJOj8HHfFggAITirZGz5TDsyVGac6WCHMsQo0Eum+T0cD5+S4p5+cZUAAfuBKQWgIUUnaBOO/2vHJWE+72k8HJQBOkziMBB9D74efM2VuEmbNLnD3M4apgu9RdP+5Bix7ZIDWL3YwrEy1Hu1iIruD7HZ/dYdHunIxYBKHr5E+Ks6Ae5uv0n/U84ZuWpVtsubuQXLiwoF7jKywiMqXHSx2tdKCi/BaxgSKiQc9Wu06AkMVmEm0QyhTi8cS9zVQTiGudjqN+krxGbUahuI+Yzf50+/8Dfg9wxjueNE7bxFapenYssZ/RSI3nHLmb2vHYlp4MVt5kqgrEomCzmWvCN9Ftt/L4fYtRJtObTO0ClorWWJJro6aldnR/TBq7eXbdM8tD+AI+DZyM4Y7nvbD8UrtW7lSmbnHdfQ6Rzwaf5fF//ybwGYYN6dvebDNVoTYYU3K611dFgQ2PFh59DBBaHSj9l2evVab0IZneI8+k/aRRm00n8Trcot9uBxtZ7sXA7fZfZLir6w==
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={"Read a revision"}
>
</Heading>

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



Returns one revision with its full definition.

<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":"path","name":"revision","required":true,"schema":{"type":"integer"},"description":"The revision number (positive integer).","example":3}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The revision.","content":{"application/json":{"schema":{"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"}}}}}},"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>