---
title: "Rerig"
method: POST
path: "/lowpoly/assets/{asset_id}/rerig"
tags: ["lowpoly"]
---

# Rerig

`POST /lowpoly/assets/{asset_id}/rerig`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/lowpoly/assets/{asset_id}/rerig`
- Auth: none declared. Required headers: `X-RD-Token`

Rebuild a rigged version's skeleton, e.g. to fix a pivot or add bones (the prompt is optional). The
version is updated in place; animations whose bones the new rig still has are kept.

## Path parameters

- `asset_id` string, required

## Headers

- `Idempotency-Key` string
- `X-RD-Token` string, required

## Request body

- LowPolyRerigInput
  - `prompt` string: What to change about the rig, up to 250 characters (optional), e.g. 'give the tail three bones' or 'hinge the door on its left edge'.
  - `version` integer: The rigged version to re-rig (default: the newest).
  - `custom_id` string

## Response `202`

Successful Response

- LowPolyTaskAccepted
  - `status` string
  - `task_id` string, required
  - `request_id` string, required
  - `asset_id` string, required
  - `operation` string, required
  - `cost` number, required
  - `size` integer, required
  - `size_source` string
  - `message` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api.md) · [All operations](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/revisions/9c76250e8e2d?raw)