---
title: "Create Pipeline"
method: POST
path: "/pipeline"
tags: ["pipeline"]
---

# Create Pipeline

`POST /pipeline`

Create and execute a texture generation pipeline.

Provide at least one of these three input modes:
1. **Existing session**: Provide ``session_id`` (from ``/upload-usd``).
2. **S3 reference**: Provide ``s3_uri``, downloads from S3 server-side.
3. **File upload**: Provide ``usd_file``, creates new session.

When multiple sources are supplied, selection follows the legacy precedence
``session_id`` > ``s3_uri`` > ``usd_file`` and lower-priority fields are
ignored. A selected S3 source is admitted only when its exact bucket name is
listed in ``TA_S3_ALLOWED_BUCKETS``; an empty allowlist rejects every client
S3 input before session-manager or S3 I/O.

Optionally provide ``material_textures_json`` to specify per-material
texture prompts, blend opacity, and per-prim overrides.

## Response `202`

Successful Response

- SessionCreated — Response when session is created.
  - `session_id` string, required
  - `status` string
  - `message` string
  - `estimated_duration_minutes` integer, nullable — Estimated completion time
  - `plan_url` string, nullable — Stable texture-plan endpoint for this session; returns 404 until planning has produced texture_plan.json.

## Other responses

- `400` — Missing, conflicting, or invalid input source, including an unsupported USD extension.
- `403` — Client S3 URI rejected by the configured bucket allowlist, or S3 access denied.
- `422` — Validation Error

## Changes

- **2026-07-21** `90f9a177effa` — 1 breaking, 31 info
  - the `usd_file` request property contentMediaType changed from `application/octet-stream` to ``
  - added the new optional request property `backend_custom_parameters_json`
  - added the new optional request property `backend_engine`
  - added the new optional request property `detail_policy`
  - …28 more
- **2026-05-27** `47f94b0bee77` — 1 info
  - added the new optional request property `auto_prompt_enabled`
- **2026-04-29** `12695b6a0290` — 1 warning
  - removed the request property `auto_prompt_enabled`

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