---
title: "Upload Usd Immediate"
method: POST
path: "/pipeline/upload-usd"
tags: ["pipeline"]
---

# Upload Usd Immediate

`POST /pipeline/upload-usd`

Upload a USD file and create a session for later pipeline execution.

Provide exactly one of these two input modes:
1. **File upload**: Provide ``usd_file`` (multipart).
2. **S3 reference**: Provide ``s3_uri`` -- the service downloads server-side.

Client S3 access is fail-closed: the exact bucket name must be listed in
``TA_S3_ALLOWED_BUCKETS``, and an empty allowlist rejects every client S3 URI
before session-manager or S3 I/O.

Use the returned session_id with ``POST /pipeline`` to start processing.

## Response `201`

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, 4 info
  - the `usd_file` request property contentMediaType changed from `application/octet-stream` to ``
  - request property `usd_file` list-of-types was widened by adding types `null` to media type `multipart/form-data`
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - …1 more

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