POST /v1/influencers/:influencerId/clone

Clones an existing influencer. The source's identity (gender, ageRange, brandVoice, language, plus the internal persona attributes) is carried forward into a new influencer in the same project. An influencer_create job then renders a new portrait conditioned on the source's identity — so the clone looks like the source unless your overrides push it elsewhere. Async — poll the returned job.

The source id is a path parameter, not a body field.

Path parameters

Body

Body is strict - unknown fields return VALIDATION.

Request

curl -X POST https://api.layers.com/v1/influencers/{influencerId}/clone \
  -H "Authorization: Bearer $LAYERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria (ES)",
    "overrides": { "language": "es-MX" }
  }'

const res = await fetch(
  `https://api.layers.com/v1/influencers/${influencerId}/clone`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.LAYERS_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Maria (ES)',
      overrides: { language: 'es-MX' },
    }),
  },
);
const { jobId, influencerId: cloneId } = await res.json();

import os, httpx

r = httpx.post(
    f"https://api.layers.com/v1/influencers/{influencer_id}/clone",
    headers={
        "Authorization": f"Bearer {os.environ[\'LAYERS_API_KEY\']}",
        "Content-Type": "application/json",
    },
    json={"name": "Maria (PT)", "overrides": {"language": "pt-BR"}},
)
job = r.json()

Responses

{
  "jobId": "job_01HY0AB...",
  "kind": "influencer_create",
  "status": "running",
  "influencerId": "inf_4a8e1bc2...",
  "locationUrl": "/v1/jobs/job_01HY0AB..."
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Influencer not found.",
    "requestId": "req_..."
  }
}

Notes

• Clone lives in the source's project. The clone inherits projectId from the source. To move an identity across projects, create a new influencer in the target project.
• Async, not sync. The job envelope is identical to create.
• Identity preserved. The job loads the source's gender, ageRange, brandVoice, language, and internal persona attributes server-side, applies your overrides on top, then renders a new portrait conditioned on the source's appearance.
• Overrides win. Anything you pass in overrides shadows the source for that field on the new row. Unspecified fields fall through to the source.

Errors

See also

• Create from scratch
• Patch the clone
• The jobs envelope