---
title: "Set a task run output"
method: POST
path: "/task_runs/{task_run_id}/outputs"
tags: ["Task Runs"]
---

# Set a task run output

`POST /task_runs/{task_run_id}/outputs`

## Request

- Base URL: `https://app.getorchestra.io/api/engine/public`
- URL: `https://app.getorchestra.io/api/engine/public/task_runs/{task_run_id}/outputs`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://app.getorchestra.io/oauth/authorize`
    - Token URL: `https://app.getorchestra.io/oauth/token` scopes: `orchestra:write`

Set a named output on a task run. Output names are lower-cased on write, matching how templating (`tasks['<task_id>'].outputs.<name>`) resolves them. Names may hold letters, digits and `_ - . / =`; read one containing `.` or `/` with bracket syntax too, e.g. `tasks['<task_id>'].outputs['moo2.txt']`.

## Path parameters

- `task_run_id` string, uuid4, required

## Headers

- `X-Orchestra-Account-Id` string, uuid4, nullable

## Request body

- SetTaskRunOutputRequestBody: Request body for setting a single output on a task run.
  - `outputName` string, required
  - `outputValue` unknown, required

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `e45165e7e223`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getorchestra/apis/orchestra-api/changes/task_runs/:task_run_id/outputs/post.md)

---

[API](https://skmtc.dev/getorchestra/apis/orchestra-api.md) - [All operations](https://skmtc.dev/getorchestra/apis/orchestra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getorchestra/apis/orchestra-api/revisions/daf2c16b3057?raw)