Sign in
Characters

Update Character

Partially update an existing character's attributes. Only include fields you want to change.

patch/api/v1/characters/{characterId}

Path parameters

characterIdstring required

Unique identifier of the character (integer or UUID)

Request body

firstNamestring

Character's first name

lastNamestring

Character's last name

biographystring

Character biography/backstory

aliasstring

Character alias/nickname

jobstring

Job title

whereYouLivestring

Location where character lives

dateOfBirthstring date

Date of birth (ISO format: YYYY-MM-DD). Age will be calculated and must be 21+

genderstring

Character gender

nationalityNationality — unresolved $ref
ethnicityEthnicity — unresolved $ref
heightstring

Character height

bodyBuildBodyBuild — unresolved $ref
bodyShapeBodyShape — unresolved $ref
buttSizeButtSize — unresolved $ref
hairLengthHairLength — unresolved $ref
hairColourHairColour — unresolved $ref
eyeColourEyeColour — unresolved $ref
skinToneSkinTone — unresolved $ref
breastSizeBreastSize — unresolved $ref
breastPertnessBreastPertness — unresolved $ref
nippleColourNippleColour — unresolved $ref
vaginaHairVaginaHair — unresolved $ref
vaginaSizeVaginaSize — unresolved $ref
orientationOrientation — unresolved $ref
sexualExperienceSexualExperience — unresolved $ref
kinksKinks — unresolved $ref
sexPositionsSexPositions — unresolved $ref
relationshipStyleRelationshipStyle — unresolved $ref
relationshipStatusRelationshipStatus — unresolved $ref
interestsInterests — unresolved $ref
personalityPersonality — unresolved $ref
sexDriveSexDrive — unresolved $ref
conversationStyleConversationStyle — unresolved $ref
attitudeAttitude — unresolved $ref
voiceIdstring

S3 URI for the voice reference audio

audioSpeednumber

Audio playback speed multiplier (0.5-2.0)

Response

Character updated successfully

successboolean required

Indicates if the update was successful

characterIdinteger required

ID of the updated character

updatedFieldsstring[] required

List of field names that were modified

messagestring required

Human-readable success message

Example response

{
  "success": true,
  "characterId": 737,
  "updatedFields": [
    "firstName",
    "lastName",
    "age"
  ],
  "message": "Character updated successfully. 3 field(s) modified."
}

Changes