---
title: "Get Session"
method: GET
path: "/sessions/{session_id}"
tags: ["sessions"]
---

# Get Session

`GET /sessions/{session_id}`

Get detailed session information with sanitized error fields.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- SessionDetail — Detail payload for ``GET /sessions/{session_id}``. Whitelists fields that are safe for public surface. Free-form strings in ``error`` and ``failed_step_stats`` are sanitized to redact NVCF function URLs and absolute session paths.
  - `session_id` string, required
  - `status` string, required
  - `created_at` string, nullable
  - `updated_at` string, nullable
  - `elapsed_seconds` integer
  - `ttl_expires_at` string, nullable
  - `config` SessionConfigSummary — Sanitized subset of pipeline config echoed back on /sessions. Excludes absolute filesystem paths (the input USD lives at a server- internal location implied by the session id; surfacing it would leak the container's storage layout).
    - `project_name` string, nullable
    - `original_filename` string, nullable — Filename the client uploaded (None for S3 inputs)
    - `input_extension` string, nullable — USD extension, e.g. '.usd' or '.usdz'
    - `has_usd_upload` boolean, nullable
    - `s3_uri` string, nullable — S3 URI when input was sourced from S3 (client-supplied)
    - `material_textures` object, nullable
  - `current_step` CurrentStepInfo — Information about the currently executing step.
    - `name` string, required — Step internal name
    - `display_name` string, required — Human-readable step name
    - `started_at` string, required — ISO timestamp when step started
    - `progress` StepProgress, required — Progress information for a single step.
      - `current` integer, required — Current progress count
      - `total` integer, required — Total items to process
      - `percent` integer, required — Percentage complete (0-100)
      - `message` string, required — Human-readable progress message
    - `elapsed_seconds` integer, required — Seconds since step started
  - `completed_steps` CompletedStepInfo[]
    - `name` string, required — Step internal name
    - `display_name` string, required — Human-readable step name
    - `started_at` string, required — ISO timestamp when step started
    - `completed_at` string, required — ISO timestamp when step completed
    - `duration_seconds` integer, required — Step duration in seconds
    - `stats` object — Step-specific statistics
  - `overall_progress` OverallProgress — Overall pipeline progress.
    - `current_step` integer, required — Current step number (1-indexed)
    - `total_steps` integer, required — Total number of steps
    - `percent` integer, required — Overall percentage complete (0-100)
    - `estimated_remaining_seconds` integer, nullable — Estimated seconds until completion
  - `preview_images` string[]
  - `can_cancel` boolean
  - `error` string, nullable — Sanitized top-level error message (failed runs)
  - `failed_step` string, nullable
  - `failed_step_stats` object, nullable
  - `partial_results` object, nullable
  - `results` object, nullable — Final stats (completed runs)
  - `duration_seconds` integer, nullable
  - `completed_at` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-30** `f1aa452697e3` — 1 breaking, 19 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `can_cancel` to the response with the `200` status
  - added the optional property `completed_at` to the response with the `200` status
  - added the optional property `completed_steps` to the response with the `200` status
  - …16 more
- **2026-04-29** `12695b6a0290` — 3 breaking, 17 warning
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `session_id` from the response with the `200` status
  - removed the required property `status` from the response with the `200` status
  - removed the optional property `can_cancel` from the response with the `200` status
  - …16 more

[Change history](https://skmtc.dev/nvidia/apis/texture-agent-service/changes/sessions/:session_id/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)