---
title: "Update Digital Twin"
method: PATCH
path: "/api/v1/digital-twins/{ohChatId}"
tags: ["Digital Twins"]
---

# Update Digital Twin

`PATCH /api/v1/digital-twins/{ohChatId}`

Updates an existing digital twin character. All fields are optional for partial updates. Note: reference image and ownership cannot be changed after creation.

## Path parameters

- `ohChatId` integer, required

## Request body

- UpdateDigitalTwinRequest — All fields are optional for partial updates. Reference image and ownership cannot be changed after creation.
  - `name` string — Character display name
  - `alias` string — Character nickname
  - `dateOfBirth` string, date — Date of birth (must remain 21+)
  - `job` string — Character occupation
  - `location` string — Where the character lives
  - `bio` string — Character biography
  - `textingStyle` string — Texting style
  - `personality` string[] — Update personality traits. Values must match valid terms — use GET /api/v1/characters/personalities for the full list
  - `interests` string[] — Update interests. Values must match valid terms — use GET /api/v1/characters/interests for the full list
  - `profileImageUrl` string, uri — New profile image URL (downloaded and saved)
  - `gender` Gender — unresolved $ref
  - `orientation` Orientation — unresolved $ref
  - `hairColour` string — Update hair colour. Use GET /api/v1/characters/hair-colours for valid values
  - `eyeColour` string — Update eye colour. Use GET /api/v1/characters/eye-colours for valid values
  - `bodyType` string — Update body type. Use GET /api/v1/characters/body-builds for valid values
  - `ethnicity` string — Update ethnicity. Use GET /api/v1/characters/ethnicities for valid values
  - `hairLength` string — Update hair length. Use GET /api/v1/characters/hair-lengths for valid values
  - `breastSize` string — Update breast size (female only). Use GET /api/v1/characters/breast-sizes for valid values
  - `vaginaHair` string — Update pubic hair style (female only). Use GET /api/v1/characters/vagina-hair for valid values
  - `contentLevel` ContentLevel — unresolved $ref
  - `tattoos` string — Update tattoo description
  - `physicalCharacteristics` string[] — Update physical characteristics (array of strings)
  - `kinks` string[] — Update kinks. Values must match valid terms — use GET /api/v1/characters/kinks for the full list
  - `relationshipStatus` string — Update relationship status
  - `backstory` string — Update character backstory
  - `referenceImageUrl` string, uri — URL to new reference image
  - `coverVideoUrl` string, uri — URL to cover video
  - `voiceUrl` string, uri — HTTP URL to voice reference audio file (.wav)
  - `audioSpeed` number, float — Audio playback speed multiplier
  - `socialHandleInstagram` string — Instagram handle
  - `socialHandleTiktok` string — TikTok handle
  - `socialHandleTwitter` string — X/Twitter handle
  - `socialHandleYoutube` string — YouTube handle
  - `socialHandleTwitch` string — Twitch handle
  - `socialHandleTelegram` string — Telegram handle
  - `earlyAccessEmail` integer — Early access email entity reference
  - `priorityPrice` number, float — Update priority subscription price (field_sub_a)
  - `platinumPrice` number, float — Update platinum subscription price (field_sub_b)
  - `vipPrice` number, float — Update vIP subscription price (field_sub_c)
  - `priorityListPrice` number, float — Update priority list price (field_list_price_a)
  - `platinumListPrice` number, float — Update platinum list price (field_list_price_b)

## Response `200`

Digital twin updated successfully

- object
  - `success` boolean
  - `digitalTwinId` string, uuid
  - `characterId` integer
  - `updatedFields` string[]
  - `message` string

## Other responses

- `400` — Invalid data - age under 21 or invalid values
- `401` — Unauthorized - invalid or missing API key
- `404` — Digital twin not found
- `500` — Server error - image download failed or database error

---

[API](https://skmtc.dev/oh/apis/ohapi-documentation.md) · [All operations](https://skmtc.dev/oh/apis/ohapi-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oh/ohapi-documentation/revisions/b623c2e9cb65/schema)