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

No recorded changes to this endpoint across all 1 revision of this API.