References

Operations of the Workflow Engine API. Paths are relative to your deployment's API host.

GET /api/workflow-engine-api/references/by-target

Inbound query: which workflow versions reference a target?

Studio "Used by" surface. Returns every workflow version (in the caller's scope: system + own org) whose parsed AST references the target (kind, slug, version). When version is omitted, every consumer of the slug is returned regardless of which version they pinned. When version is set, consumers that pinned the exact version OR that left version unspecified (latest-active resolution) are both returned. The result joins the consuming workflow row for slug/title so the panel can render clickable rows.

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/workflow-engine-api/workflows/{slug}/revisions/{revisionNumber}/references

Outbound references emitted by a workflow revision's parsed AST.

Returns one row per (refKind, refSlug, refVersion, sourcePath) the workflow points at — deliverable specs, workspace manifests, agents, action manifests, and reusable workflows discovered by walking jobs[*].uses and jobs[*].with.*. Expression refs (\${{ ... }}) are NOT indexed since they resolve at run time from trigger inputs or upstream outputs. Drives the Studio Related panel's 'this workflow uses…' surface; inverse used-by queries land in a sibling endpoint on each owner service.

Authentication: bearer token (Authorization: Bearer <token>)