> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows and runs API

> HTTP API operations to author and dispatch workflows, follow and control runs, read outcomes and files, and work with procedures and Factories.

These operations cover work from definition to result: author a workflow draft, publish it, dispatch a run, follow the run's steps and events, and read the outcome it produced. Procedures, Files and Factories are the building blocks and production units runs use. Every path here is under `/api/v3`; see [authentication and permissions](https://docs.gloo.com/forge/reference/permissions) for the credential each operation takes.

## Domains

> [card] [Workflows](https://docs.gloo.com/forge/reference/http-api/workflows)
>
> Drafts, versions, input schemas and dispatch.

> [card] [Runs](https://docs.gloo.com/forge/reference/http-api/runs)
>
> Run detail, steps, events and run control.

> [card] [Outcomes](https://docs.gloo.com/forge/reference/http-api/outcomes)
>
> The governed outcome a run produced, with its evidence.

> [card] [Files](https://docs.gloo.com/forge/reference/http-api/files)
>
> Upload files and download uploads and run outputs.

> [card] [Procedures](https://docs.gloo.com/forge/reference/http-api/procedures)
>
> The procedure catalog and the shims a running procedure calls.

> [card] [Factories](https://docs.gloo.com/forge/reference/http-api/factories)
>
> Autonomous production units, their workers and tasks.

## Common tasks

| Task | Operation |
| - | - |
| List workflows | [`GET /api/v3/workflows`](https://docs.gloo.com/forge/reference/http-api/workflows/list) |
| Publish a workflow draft | [`POST /api/v3/workflows/{workflowId}/publish-draft`](https://docs.gloo.com/forge/reference/http-api/workflows/publishDraft) |
| Dispatch a workflow run | [`POST /api/v3/workflows/dispatch`](https://docs.gloo.com/forge/reference/http-api/workflows/dispatch) |
| Read a run with its steps | [`GET /api/v3/runs/{runId}`](https://docs.gloo.com/forge/reference/http-api/runs/get) |
| Read a run's outcome | [`GET /api/v3/outcomes/{outcomeId}`](https://docs.gloo.com/forge/reference/http-api/outcomes/get) |

## Related

* [Compose a workflow](https://docs.gloo.com/forge/build/compose-a-workflow.md)
* [Workflows and runs concepts](https://docs.gloo.com/forge/concepts/workflows-and-runs.md)
* [Procedures](https://docs.gloo.com/forge/concepts/procedures.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.