---
title: "Regenerate clone headshot"
method: POST
path: "/public/v1/clones/{cloneId}/headshot/generate"
tags: ["Clones"]
---

# Regenerate clone headshot

`POST /public/v1/clones/{cloneId}/headshot/generate`

Triggers asynchronous headshot regeneration for a clone. Returns immediately with 202 Accepted.
Poll `GET /clones/{cloneId}/profile` and check `state.headshot` for progress.

An optional request body can include `additionalInstructions` to nudge the appearance
(e.g. "longer hair", "wearing glasses"). An empty body performs a standard regeneration.

## Path parameters

- `cloneId` string, required

## Request body

- GenerateRequest
  - `additionalInstructions` string — Optional instructions to nudge the generation (e.g. "deeper voice", "longer hair")

## Response `202`

Generation started

- GenerationStatusResponse
  - `status` string, required

## Other responses

- `400` — Bad request
- `401` — Missing or invalid API key
- `403` — API key lacks required scope
- `404` — Resource not found
- `409` — Headshot generation is already in progress

## Changes

- **2026-03-22** `0841f04b6bd8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/clone-global/apis/cloneforce-platform-api/changes/public/v1/clones/:cloneId/headshot/generate/post.md)

---

[API](https://skmtc.dev/clone-global/apis/cloneforce-platform-api.md) · [All operations](https://skmtc.dev/clone-global/apis/cloneforce-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clone-global/cloneforce-platform-api/revisions/0841f04b6bd8/schema)