{
"message": "Character: character789 has been updated with the following context.",
"character_id": "character789",
"character_context": {
"age": "adult",
"description": "A brave warrior with a mysterious past.",
"gender": "Male",
"items": [
{
"itemName": "sword",
"unit": "Piece",
"value": 100
}
],
"name": "Aragorn",
"quests": [
{
"description": "Retrieve the lost artifact.",
"objective": "Find and return the artifact.",
"reward": "500 gold coins"
}
],
"role": "protagonist",
"tone": "mysterious",
"traits": [
"brave"
],
"personality_theory": "basicTraits",
"personality_dimensions": {}
}
}
{
"message": "An error occurred"
}
{
"message": "Possible reasons:\n- Character not found\n"
}
{
"message": "An error occurred"
}
Characters
Update character details
Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.
{
"age": "adult",
"description": "A brave warrior with a mysterious past.",
"gender": "Male",
"items": [
{
"itemName": "sword",
"unit": "Piece",
"value": 100
}
],
"name": "Aragorn",
"quests": [
{
"description": "Retrieve the lost artifact.",
"objective": "Find and return the artifact.",
"reward": "500 gold coins"
}
],
"role": "protagonist",
"tone": "mysterious",
"traits": ["brave"],
"personality_theory": "basicTraits",
"personality_dimensions": {}
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"NPC Builder","colors":{"primary":"#359BFA","light":"#359BFA","dark":"#0568c4"},"logo":{"light":"https://mintcdn.com/npcbuilder/0CmGufgM37ouZbOi/logo/light.svg?fit=max\u0026auto=format\u0026n=0CmGufgM37ouZbOi\u0026q=85\u0026s=21547db5a4d1774f17945bfd86336bc0","dark":"https://mintcdn.com/npcbuilder/0CmGufgM37ouZbOi/logo/dark.svg?fit=max\u0026auto=format\u0026n=0CmGufgM37ouZbOi\u0026q=85\u0026s=e633c1ee307d9a3a29fc2f98d2d9303b","href":"https://docs.npcbuilder.com"},"favicon":"https://mintcdn.com/npcbuilder/R4Y8o_1f-ZPlMdqS/favicon.svg?fit=max\u0026auto=format\u0026n=R4Y8o_1f-ZPlMdqS\u0026q=85\u0026s=98df48f15eaac008aba7d9697b8d62ea","navbar":{"links":[{"href":"mailto:support@npcbuilder.com","label":"Support"},{"icon":"calendar-check","href":"https://npcbuilder.com/plans","label":"Subscribe"}],"primary":{"type":"button","label":"App","href":"https://app.npcbuilder.com"}},"footer":{"socials":{"x":"https://x.com/npc_builder","github":"https://github.com/NPC-Builder","linkedin":"https://www.linkedin.com/company/npc-builder","youtube":"https://www.youtube.com/@NPCBuilderApp","instagram":"https://www.instagram.com/npc_builder"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"book-open-cover","href":"https://npcbuilder.com/"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/9D6Xdj2MPU"}]},"languages":[{"language":"en","href":""},{"language":"es","href":"es"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"npcbuilder","hasAudioNarration":false,"actualSubdomain":"npcbuilder","customDomains":["docs.npcbuilder.com"],"gitSource":{"type":"github","owner":"npc-builder","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e7608d1fcd719df0531d","collectionId":"440e3997-f4e1-4d2f-8504-a1fc02f1af1f","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21e7608d1fcd719df0531d:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"en","tag":"API reference","count":24},{"language":"es","tag":"Referencia de API","count":24},{"language":"en","tag":"Endpoints","count":23},{"language":"es","tag":"Endpoints","count":23},{"language":"en","tag":"Guides","count":6},{"language":"en","tag":"Getting started","count":4},{"language":"en","tag":"Characters","count":4},{"language":"en","tag":"Interactions","count":4},{"language":"en","tag":"Locations","count":4},{"language":"en","tag":"Regions","count":4},{"language":"en","tag":"Worlds","count":4},{"language":"es","tag":"Characters","count":4},{"language":"es","tag":"Interactions","count":4},{"language":"es","tag":"Locations","count":4},{"language":"es","tag":"Regions","count":4},{"language":"es","tag":"Worlds","count":4},{"language":"en","tag":"Sessions","count":3},{"language":"es","tag":"Guías","count":3},{"language":"es","tag":"Sessions","count":3},{"language":"es","tag":"Integraciones","count":2}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#card img,#navbar img{width:180px;height:auto}#card img{width:80px}"}],"page":{"pagePath":"api-reference/characters/update-character-details","slug":"/api-reference/characters/update-character-details","pageMetadata":{"title":"Update character details","description":"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /context/characters/{game_id}/{world_id}/{character_id}","href":"/api-reference/characters/update-character-details","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update character details","description":"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /context/characters/{game_id}/{world_id}/{character_id}","href":"/api-reference/characters/update-character-details","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update character details","tags":["Characters"],"description":"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\n","parameters":["3107cf0a-e49c-4e05-a9a1-5b6fadd25bf7","ac8691dd-a556-43de-9405-d58ca80f366d","fcf25aad-db2a-4def-9f78-34ee3bb071e6","18da43d7-f6bc-4ef1-b2b6-4ad5f8be2b02"],"requestBody":"75d052be-25e4-4356-9a6f-53bf5f08b3d2","responses":{"200":"6881bde1-b161-4d27-b3b4-53873accd952","400":"65d3f97f-8bd9-478c-8442-c06e15eb04dd","404":"f5ea9613-8b0a-48ae-8405-4c2e175c02d4","500":"f0193469-70d9-4231-92c1-403ad1fdae60"},"security":["eb4e59a3-b03c-418e-a65c-b851bf8e5d31"],"method":"patch","type":"path","servers":["e6474d3b-eae2-4e6e-b5b0-b9eb6222e76b"],"path":"/context/characters/{game_id}/{world_id}/{character_id}","baseUrlOptions":["https://app.npcbuilder.com/api"],"title":"Update character details","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3107cf0a-e49c-4e05-a9a1-5b6fadd25bf7":{"name":"game_id","in":"path","required":true,"description":"The unique identifier for the game.","schema":{"type":"string","example":"game123","isRequired":true,"description":"The unique identifier for the game.","uniqueKey":"","typeLabel":"string"}},"ac8691dd-a556-43de-9405-d58ca80f366d":{"name":"world_id","in":"path","required":true,"description":"The unique identifier for the world.","schema":{"type":"string","example":"world456","isRequired":true,"description":"The unique identifier for the world.","uniqueKey":"","typeLabel":"string"}},"fcf25aad-db2a-4def-9f78-34ee3bb071e6":{"name":"character_id","in":"path","required":true,"description":"The unique identifier for the character.","schema":{"type":"string","example":"character789","isRequired":true,"description":"The unique identifier for the character.","uniqueKey":"","typeLabel":"string"}},"18da43d7-f6bc-4ef1-b2b6-4ad5f8be2b02":{"name":"session_id","in":"query","description":"(Optional) The player's session ID.","required":false,"schema":{"type":"string","example":"60Z5aZjIuFlyYbjbZZKe","isRequired":false,"description":"(Optional) The player's session ID.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"description":"The character data fields to update.","content":{"application/json":{"schema":{"type":"object","properties":{"age":{"type":"string","description":"The age category of the character.","enum":["infant","child","teenager","youngAdult","adult","middleAged","elderly"],"example":"adult","uniqueKey":"age","typeLabel":"enum\u003cstring>"},"description":{"type":"string","description":"A brief description of the character.","example":"A brave warrior with a mysterious past.","uniqueKey":"description","typeLabel":"string"},"gender":{"type":"string","description":"The gender of the character.","example":"Male","uniqueKey":"gender","typeLabel":"string"},"model":{"type":"string","description":"The AI model used to power character interactions. Premium models are available only for some subscriptions.","enum":["standard","premium"],"example":"standard","uniqueKey":"model","typeLabel":"enum\u003cstring>"},"filters":{"type":"object","description":"Structured content filters applied to the character's responses. Provide the toggles you want to update when adjusting moderation settings.\n","properties":{"active":{"type":"boolean","description":"Enables or disables all filters for the character.","uniqueKey":"filters.active","typeLabel":"boolean"},"violence":{"type":"boolean","description":"Reinforces violent or gory content in character responses.","uniqueKey":"filters.violence","typeLabel":"boolean"},"sexual":{"type":"boolean","description":"Reinforces sexual or suggestive content in character responses.","uniqueKey":"filters.sexual","typeLabel":"boolean"},"drugs":{"type":"boolean","description":"Reinforces references to drug use or paraphernalia in character responses.","uniqueKey":"filters.drugs","typeLabel":"boolean"}},"example":{"active":true,"violence":true,"sexual":false,"drugs":false},"uniqueKey":"filters","typeLabel":"object"},"items":{"type":"array","description":"A list of updated items for the character.","items":{"oneOf":[{"type":"object","description":"Schema for items of type \"trade\"","required":["type","itemName","unit","value"],"properties":{"type":{"type":"string","description":"The type of item.","enum":["trade"],"example":"trade","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"itemName":{"type":"string","description":"The name of the trade item.","example":"sword","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.0.itemName","typeLabel":"string"},"unit":{"type":"string","description":"The measurement unit.","example":"Piece","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.0.unit","typeLabel":"string"},"value":{"type":"number","description":"The cost or value of the item.","example":100,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.0.value","typeLabel":"number"},"description":{"type":"string","description":"A detailed description of the item.","example":"A sharp sword.","uniqueKey":"\\items.items.[INDEX].oneOf.0.description","typeLabel":"string"}},"uniqueKey":"\\items.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Schema for items of type \"action\"","required":["type","itemName","description"],"properties":{"type":{"type":"string","description":"The type of item.","enum":["action"],"example":"trade","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"itemName":{"type":"string","description":"The name of the action.","example":"Move","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.itemName","typeLabel":"string"},"description":{"type":"string","description":"A description of the action.","example":"Move to position","isRequired":true,"uniqueKey":"\\items.items.[INDEX].oneOf.1.description","typeLabel":"string"}},"uniqueKey":"\\items.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"\\items","typeLabel":"object[]"},"events":{"type":"array","description":"A list of events related to the character.","items":{"oneOf":[{"type":"object","description":"Schema for events of type \"action\"","required":["type","eventName"],"properties":{"type":{"type":"string","description":"The type of event.","enum":["action"],"example":"item","isRequired":true,"uniqueKey":"events.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"eventName":{"type":"string","description":"The name of the event.","example":"Attack","isRequired":true,"uniqueKey":"events.items.[INDEX].oneOf.0.eventName","typeLabel":"string"},"description":{"type":"string","description":"Detailed event description.","example":"Act of violence against another person.","uniqueKey":"events.items.[INDEX].oneOf.0.description","typeLabel":"string"}},"uniqueKey":"events.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Schema for events of type \"item\"","required":["type","eventName"],"properties":{"type":{"type":"string","description":"The type of event.","enum":["item"],"example":"item","isRequired":true,"uniqueKey":"events.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"eventName":{"type":"string","description":"The name of the event.","example":"Give","isRequired":true,"uniqueKey":"events.items.[INDEX].oneOf.1.eventName","typeLabel":"string"},"description":{"type":"string","description":"Detailed event description.","example":"Provide an object to a person.","uniqueKey":"events.items.[INDEX].oneOf.1.description","typeLabel":"string"}},"uniqueKey":"events.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"events.items.[INDEX]","typeLabel":"object"},"uniqueKey":"events","typeLabel":"object[]"},"name":{"type":"string","description":"The display name of the character.","example":"Aragorn","uniqueKey":"name","typeLabel":"string"},"quests":{"type":"array","description":"A list of quests associated with the character.","items":{"type":"object","properties":{"description":{"type":"string","description":"A brief description of the quest.","example":"Retrieve the lost artifact.","uniqueKey":"quests.items.[INDEX].description","typeLabel":"string"},"objective":{"type":"string","description":"The quest's main objective.","example":"Find and return the artifact.","uniqueKey":"quests.items.[INDEX].objective","typeLabel":"string"},"reward":{"type":"string","description":"The reward for quest completion.","example":"500 gold coins","uniqueKey":"quests.items.[INDEX].reward","typeLabel":"string"}},"uniqueKey":"quests.items.[INDEX]","typeLabel":"object"},"uniqueKey":"quests","typeLabel":"object[]"},"role":{"type":"string","description":"The role the character plays in the game.","enum":["noRole","protagonist","antagonist","secondaryCharacter","tertiaryCharacter","mentor","enemy","villain","rival","shopkeeper","healer","questGiver","innkeeper","guard","familyMember","loveInterest","scientist","politician","criminal","explorer","wizard","ghost","animalCompanion","artificialIntelligence"],"example":"protagonist","uniqueKey":"role","typeLabel":"enum\u003cstring>"},"tone":{"type":"string","description":"The style or mood of the character's dialogue.","enum":["formal","casual","sarcastic","mysterious","emotive"],"example":"mysterious","uniqueKey":"tone","typeLabel":"enum\u003cstring>"},"traits":{"type":"array","description":"Legacy/basic trait list. When provided without personality_theory, the API stores the character as basicTraits.","items":{"type":"string","example":"brave","uniqueKey":"traits.items.[INDEX]","typeLabel":"string"},"uniqueKey":"traits","typeLabel":"string[]"},"personality_theory":{"type":"string","description":"Personality framework used by interactions.","enum":["basicTraits","bigFive","darkTriad","dndAlignment","mbti","enneagram"],"default":"basicTraits","example":"basicTraits","uniqueKey":"personality_theory","typeLabel":"enum\u003cstring>"},"personality_dimensions":{"type":"object","description":"Dimension values for the selected personality_theory. basicTraits uses traits and an empty object.","additionalProperties":{"type":"integer","uniqueKey":"personality_dimensions.additionalProperties","typeLabel":"integer"},"example":{"machiavellianism":4,"narcissism":2,"psychopathy":1},"uniqueKey":"personality_dimensions","typeLabel":"object"},"speech_pattern":{"type":"object","description":"Optional speech style controls consumed by interactions.","properties":{"vocabulary_level":{"type":"string","enum":["simple","moderate","sophisticated","archaic"],"example":"sophisticated","uniqueKey":"speech_pattern.vocabulary_level","typeLabel":"enum\u003cstring>"},"sentence_length":{"type":"string","enum":["terse","average","verbose"],"example":"terse","uniqueKey":"speech_pattern.sentence_length","typeLabel":"enum\u003cstring>"},"verbal_quirks":{"type":"string","example":"Always says 'dear friend'","uniqueKey":"speech_pattern.verbal_quirks","typeLabel":"string"}},"uniqueKey":"speech_pattern","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"age":"adult","description":"A brave warrior with a mysterious past.","gender":"Male","model":"standard","filters":{"active":true,"violence":true,"sexual":false,"drugs":false},"items":[{"type":"trade","itemName":"sword","unit":"Piece","value":100,"description":"A sharp sword."}],"events":[{"type":"item","eventName":"Attack","description":"Act of violence against another person."}],"name":"Aragorn","quests":[{"description":"Retrieve the lost artifact.","objective":"Find and return the artifact.","reward":"500 gold coins"}],"role":"protagonist","tone":"mysterious","traits":["brave"],"personality_theory":"basicTraits","personality_dimensions":{"machiavellianism":4,"narcissism":2,"psychopathy":1},"speech_pattern":{"vocabulary_level":"sophisticated","sentence_length":"terse","verbal_quirks":"Always says 'dear friend'"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6881bde1-b161-4d27-b3b4-53873accd952":{"description":"Character updated successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Confirmation message after updating the character.","example":"Character: character789 has been updated with the following context.","uniqueKey":"message","typeLabel":"string"},"character_id":{"type":"string","description":"UID of the character.","example":"character789","uniqueKey":"character_id","typeLabel":"string"},"character_context":{"type":"object","description":"Updated character context data.","example":{"age":"adult","description":"A brave warrior with a mysterious past.","gender":"Male","items":[{"itemName":"sword","unit":"Piece","value":100}],"name":"Aragorn","quests":[{"description":"Retrieve the lost artifact.","objective":"Find and return the artifact.","reward":"500 gold coins"}],"role":"protagonist","tone":"mysterious","traits":["brave"],"personality_theory":"basicTraits","personality_dimensions":{}},"uniqueKey":"character_context","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Character: character789 has been updated with the following context.","character_id":"character789","character_context":{"age":"adult","description":"A brave warrior with a mysterious past.","gender":"Male","items":[{"itemName":"sword","unit":"Piece","value":100}],"name":"Aragorn","quests":[{"description":"Retrieve the lost artifact.","objective":"Find and return the artifact.","reward":"500 gold coins"}],"role":"protagonist","tone":"mysterious","traits":["brave"],"personality_theory":"basicTraits","personality_dimensions":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"65d3f97f-8bd9-478c-8442-c06e15eb04dd":{"description":"Validation error – Request payload did not meet schema requirements.\n","content":{"application/json":{"schema":{"type":"object","description":"Standard error response schema.","properties":{"message":{"type":"string","description":"Detailed error message.","example":"An error occurred","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"An error occurred"}}},"exampleType":"generated"}},"exampleType":"generated"},"f5ea9613-8b0a-48ae-8405-4c2e175c02d4":{"description":"Not Found – The specified character or context does not exist.\n","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error message with potential reasons.","example":"Possible reasons:\n- Character not found\n","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Possible reasons:\n- Character not found\n"}}},"exampleType":"generated"}},"exampleType":"generated"},"f0193469-70d9-4231-92c1-403ad1fdae60":{"description":"Internal Server Error – An error occurred while updating the character.\n","content":{"application/json":{"schema":{"type":"object","description":"Standard error response schema.","properties":{"message":{"type":"string","description":"Detailed error message.","example":"An error occurred","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"An error occurred"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"eb4e59a3-b03c-418e-a65c-b851bf8e5d31":{"npcbuilder_auth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"e6474d3b-eae2-4e6e-b5b0-b9eb6222e76b":{"url":"https://app.npcbuilder.com/api","description":"Production API for context, sessions, and non-interaction endpoints"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"npcbuilder_auth","name":"Authorization"}],"title":"npcbuilder_auth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"npcbuilder","siteName":"NPC Builder","title":"Update character details - NPC Builder","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/characters/update-character-details","matchLevel":0},"es":{"href":"/es","matchLevel":4}}},"lastModified":"2026-05-23T17:44:12.388Z","originalFileLocation":"api-reference/characters/update-character-details.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\">\u003cmeta data-mint-head name=\"application-name\" content=\"NPC Builder\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update character details - NPC Builder\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"NPC Builder\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.npcbuilder.com/api-reference/characters/update-character-details\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://npcbuilder.mintlify.app/_mintlify/api/og/v2?division=Characters\u0026amp;title=Update+character+details\u0026amp;description=Update+the+details+of+an+existing+character.+Provide+any+of+the+updatable+fields+such+as+age%2C+description%2C+gender%2C+items%2C+events%2C+quests%2C+role%2C+tone%2C+or+traits.\u0026amp;theme=f88d1efe1e5661d6a3055fa0\u0026amp;signature=066e9892950489936197686991fb22b2271534b2af3ea0a9ab613bbe46003b91\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update character details - NPC Builder\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://npcbuilder.mintlify.app/_mintlify/api/og/v2?division=Characters\u0026amp;title=Update+character+details\u0026amp;description=Update+the+details+of+an+existing+character.+Provide+any+of+the+updatable+fields+such+as+age%2C+description%2C+gender%2C+items%2C+events%2C+quests%2C+role%2C+tone%2C+or+traits.\u0026amp;theme=f88d1efe1e5661d6a3055fa0\u0026amp;signature=066e9892950489936197686991fb22b2271534b2af3ea0a9ab613bbe46003b91\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/npcbuilder/C1Zsc-PmxoJsczfU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"NPC Builder\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#359BFA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.npcbuilder.com/api-reference/characters/update-character-details\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/characters/update-character-details.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.npcbuilder.com/#organization\",\"name\":\"NPC Builder\",\"url\":\"https://docs.npcbuilder.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/npcbuilder/0CmGufgM37ouZbOi/logo/light.svg?fit=max\u0026auto=format\u0026n=0CmGufgM37ouZbOi\u0026q=85\u0026s=21547db5a4d1774f17945bfd86336bc0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.npcbuilder.com#website\",\"name\":\"NPC Builder\",\"url\":\"https://docs.npcbuilder.com\",\"publisher\":{\"@id\":\"https://docs.npcbuilder.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details#webpage\",\"url\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details\",\"name\":\"Update character details\",\"description\":\"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\",\"dateModified\":\"2026-05-23T17:44:12.388Z\",\"isPartOf\":{\"@id\":\"https://docs.npcbuilder.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.npcbuilder.com/api-reference/interactions/obtain-a-response-from-an-npc-character\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Characters\",\"item\":\"https://docs.npcbuilder.com/api-reference/characters/create-a-new-character\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update character details\",\"item\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details#apireference\",\"headline\":\"Update character details\",\"name\":\"Update character details\",\"description\":\"Update the details of an existing character. Provide any of the updatable fields such as age, description, gender, items, events, quests, role, tone, or traits.\",\"url\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details\",\"mainEntityOfPage\":{\"@id\":\"https://docs.npcbuilder.com/api-reference/characters/update-character-details#webpage\"},\"dateModified\":\"2026-05-23T17:44:12.388Z\",\"publisher\":{\"@id\":\"https://docs.npcbuilder.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.npcbuilder.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"NPC Builder\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"NPC Builder","nav":{"global":{"anchors":[{"anchor":"Website","icon":"book-open-cover","href":"https://npcbuilder.com/"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/9D6Xdj2MPU"}]},"languages":[{"language":"en","tabs":[{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","icon":"code","pages":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Uids","href":"/api-reference/uids"},{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Endpoints","pages":[{"group":"Interactions","pages":[{"title":"Obtain a response from an NPC character","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /interactions","href":"/api-reference/interactions/obtain-a-response-from-an-npc-character"},{"title":"List conversations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /conversations","href":"/api-reference/interactions/list-conversations"},{"title":"Create a new conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /conversations","href":"/api-reference/interactions/create-a-new-conversation"},{"title":"Get conversation history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /conversations/{id}","href":"/api-reference/interactions/get-conversation-history"}]},{"group":"Characters","pages":[{"title":"Create a new character","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /context/characters/{game_id}/{world_id}","href":"/api-reference/characters/create-a-new-character"},{"title":"Get character details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /context/characters/{game_id}/{world_id}/{character_id}","href":"/api-reference/characters/get-character-details"},{"title":"Delete a character","description":"Remove a character from the specified game and world. Use this operation with caution as it permanently deletes the character.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /context/characters/{game_id}/{world_id}/{character_id}","href":"/api-reference/characters/delete-a-character"},{"title":"Update character details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /context/characters/{game_id}/{world_id}/{character_id}","href":"/api-reference/characters/update-character-details"}]},{"group":"Worlds","pages":[{"title":"Create a new world","description":"Create a new world within the game. Provide world details such as lore, name, creatures, and similar worlds for reference.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /context/world/{game_id}","href":"/api-reference/worlds/create-a-new-world"},{"title":"Get world details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /context/world/{game_id}/{world_id}","href":"/api-reference/worlds/get-world-details"},{"title":"Delete a world","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /context/world/{game_id}/{world_id}","href":"/api-reference/worlds/delete-a-world"},{"title":"Update world details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /context/world/{game_id}/{world_id}","href":"/api-reference/worlds/update-world-details"}]},{"group":"Regions","pages":[{"title":"Create a new region","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /context/region/{game_id}/{world_id}","href":"/api-reference/regions/create-a-new-region"},{"title":"Get region details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /context/region/{game_id}/{world_id}/{region_id}","href":"/api-reference/regions/get-region-details"},{"title":"Delete a region","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /context/region/{game_id}/{world_id}/{region_id}","href":"/api-reference/regions/delete-a-region"},{"title":"Update region details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /context/region/{game_id}/{world_id}/{region_id}","href":"/api-reference/regions/update-region-details"}]},{"group":"Locations","pages":[{"title":"Create a new location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /context/location/{game_id}/{world_id}/{region_id}","href":"/api-reference/locations/create-a-new-location"},{"title":"Get location details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /context/location/{game_id}/{world_id}/{location_id}","href":"/api-reference/locations/get-location-details"},{"title":"Delete a location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /context/location/{game_id}/{world_id}/{location_id}","href":"/api-reference/locations/delete-a-location"},{"title":"Update location details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /context/location/{game_id}/{world_id}/{location_id}","href":"/api-reference/locations/update-location-details"}]},{"group":"Sessions","pages":[{"title":"Retrieve session information","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessionmanager","href":"/api-reference/sessions/retrieve-session-information"},{"title":"Create a new session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessionmanager","href":"/api-reference/sessions/create-a-new-session"},{"title":"Delete a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /sessionmanager","href":"/api-reference/sessions/delete-a-session"}]}]}]}]},{"language":"es","pages":[{"title":"es","href":"/es"}]}]},"title":"Update character details - NPC Builder","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}