---
id: workflow-list-callers
title: List callers
description: >-
  Lists the workflows that call this one as a sub-workflow, paginated. A
  workflow counts as a caller when its latest revision, or the revision of one
  of its active aliases, has a `sub-workflow` step that points at this
  workflow's id or key. The workflow itself is never listed.
sidebar_label: List callers
hide_title: true
hide_table_of_contents: true
api: >-
  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
sidebar_class_name: get api-method
info_path: docs/api/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-list-callers'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List callers"}
>
</Heading>

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

</MethodEndpoint>

Lists the workflows that call this one as a sub-workflow, paginated. A workflow counts as a caller when its latest revision, or the revision of one of its active aliases, has a `sub-workflow` step that points at this workflow's id or key. The workflow itself is never listed.

Use `unpinned=true` before you change a workflow, to find the callers that pick up the change. An unpinned call sets no `revision` and no `alias` other than `latest`, so it runs this workflow's latest revision.

<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":"unpinned","schema":{"type":"string","enum":["true","false"]},"description":"`true`: only callers with at least one unpinned call. `false`: only callers whose every call is pinned. Omit it to get every caller."},{"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 calling workflows.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"title":"Workflow","type":"object","required":["id","name","createdAt","updatedAt"],"properties":{"id":{"type":"string","example":"wf_ifWBbWfpug0n"},"key":{"type":"string","example":"ami-drift-scanner"},"name":{"type":"string","example":"AMI drift scanner"},"description":{"type":"string"},"path":{"type":"string","example":"/action-items/ami-drift"},"organizationId":{"type":"string"},"nrn":{"type":"string"},"metadata":{"type":"object"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}},"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>

