> ## 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.

# Outcomes

> Read the governed outcome a workflow run produced, with its evidence references and pending states.

An outcome is the governed claim a completed workflow run makes: a headline and summary, a claimed status, metrics and exceptions, each backed by evidence references. Outcome reads require `runs:read`, decided like every run read: the caller must be able to read the run that produced the outcome at the run's home and at every company on it.

* [Get outcome](https://docs.gloo.com/forge/reference/http-api/outcomes/get.md)
* [Get outcome dossier](https://docs.gloo.com/forge/reference/http-api/outcomes/getDossier.md): the full dossier Console shows, without any person's identity.
* [Get run outcome](https://docs.gloo.com/forge/reference/http-api/outcomes/getForRun.md): the state of one attempt, including pending, invalid and not-declared outcomes.
* [List outcomes](https://docs.gloo.com/forge/reference/http-api/outcomes/list.md): newest first, or one project's outcomes with `projectId`.
* [List objective contributions](https://docs.gloo.com/forge/reference/http-api/outcomes/listObjectiveContributions.md): what outcomes contributed to an objective, under `objectives:read`.
* [Rate outcome](https://docs.gloo.com/forge/reference/http-api/outcomes/rate.md): a 1-5 rating by the workflow's owner or a `platform:manage` holder, under `workflows:use`.

## What an `Outcome` carries

The claim (`headline`, `summary`, `claimedStatus`, `period`), `metrics` and `exceptions` with their `evidence` references exactly as stored, `humanReviewStatus`, the Judge `evaluation` summary, the recorded token `cost` of the attempt and of every attempt up to it (with its coverage), and the latest person `rating` value and time.

Evidence references (`step_output`, `approval`, `file`) are not content: read file bytes through [Files](https://docs.gloo.com/forge/reference/http-api/files) and step outputs through [Get run](https://docs.gloo.com/forge/reference/http-api/runs/get.md), each under its own permission.

The origin (chat channel, session and message, the launching principal), human decisions, the trust receipt, project and objective names, who rated and the rating notes are never returned.


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