---
title: "Get Pipeline Results"
method: GET
path: "/pipeline/{session_id}/results"
tags: ["pipeline"]
---

# Get Pipeline Results

`GET /pipeline/{session_id}/results`

Get pipeline execution results (only available when completed).

Reads from the same merged disk+bus view as ``/sessions/{sid}`` and
``/pipeline/{sid}/status``: when the bus has reached a terminal status
but ``_persist_status`` hasn't yet awaited its disk write, a disk-only
read here would briefly return 202 ("still running") while the other
two endpoints already report "completed".

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- union
  - PipelineResults — Pipeline execution results.
    - `session_id` string, required
    - `status` string, required
    - `stats` object — Execution statistics
    - `download_urls` object — URLs to download artifacts
    - `duration_seconds` integer, required — Total pipeline duration in seconds
    - `completed_at` string, required — ISO timestamp when completed
  - PipelineError — Pipeline error response.
    - `session_id` string, required
    - `status` string
    - `error_message` string, required — Error description
    - `failed_step` string, required — Step that failed
    - `completed_steps` string[] — Steps completed before failure
    - `partial_results` object, nullable — Partial results if available
    - `failed_step_stats` object, nullable — Stats from the failed step at the moment it raised, including any structured per-unit errors (e.g. ``errors`` and ``textures_failed`` for texture-generation/blend steps). Lets REST consumers without an SSE subscription diagnose threshold-gated failures without grepping container logs.

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-30** `f1aa452697e3` — 1 info
  - added the optional property `anyOf[subschema #2: PipelineError]/failed_step_stats` to the response with the `200` status
- **2026-04-29** `12695b6a0290` — 1 warning
  - removed the optional property `anyOf[subschema #2: PipelineError]/failed_step_stats` from the response with the `200` status

[Change history](https://skmtc.dev/nvidia/apis/texture-agent-service/changes/pipeline/:session_id/results/get.md)

---

[API](https://skmtc.dev/nvidia/apis/texture-agent-service.md) · [All operations](https://skmtc.dev/nvidia/apis/texture-agent-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/texture-agent-service/revisions/1ba426fbca03/schema)
