---
title: "Pose"
method: POST
path: "/v1/jobs/{job_id}/pose"
tags: ["jobs"]
---

# Pose

`POST /v1/jobs/{job_id}/pose`

## Request

- Base URL: `https://api.mocapless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mocapless.com/v1/jobs/{job_id}/pose`
- Auth: none declared

Re-export a finished clip with hands, feet or hips moved at chosen
frames. The limbs are solved on the existing motion and the change fades
into the frames around each edit. Costs nothing: no model call.

## Path parameters

- `job_id` string, required

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- PoseEditRequest: Hands, feet or hips dragged to new places at chosen frames. Free: the limbs are re-solved on the existing motion and only the retarget runs.
  - `edits` PoseEditItem[], required
    - `frame` integer, required
    - `joint` string, required
    - `target` number[]
    - `rotation` number[], nullable
  - `falloff` number
  - `mode` string
  - `formats` string[]

## Response `202`

Successful Response

- JobResponse
  - `id` string, required
  - `status` string, required
  - `stage` string, required
  - `progress` number, required
  - `prompt` string, required
  - `error` string, nullable, required
  - `creditsCost` integer, required
  - `creditsRefunded` boolean, required
  - `frames` integer, required
  - `durationSeconds` number, required
  - `assetId` string, nullable, required
  - `createdAt` string, date-time, required
  - `finishedAt` string, date-time, nullable, required
  - `script` ScriptModel
    - `segments` SegmentModel[], required
      - `primitive` string, required
      - `seconds` number
      - `speed` number
      - `amplitude` number
      - `style` string
      - `repeats` integer
      - `mirror` boolean
      - `turn` number
      - `params` object
    - `fps` integer
    - `loop` boolean
    - `source` string
    - `confidence` number
    - `notes` string[]
    - `prompt` string
    - `duration` number
    - `beats` object[]
    - `family` string
  - `outputs` JobOutput[]
    - `kind` string, required
    - `url` string, required
    - `locked` boolean
  - `rating` integer, nullable
  - `ratingStars` integer, nullable
  - `engine` string
  - `fallbackFrom` string, nullable
  - `variant` string

## Other responses

- `422`: Validation Error

---

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