Skip to main content
PATCH
Actualizar detalles del personaje

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

game_id
string
requerido

El identificador único del juego.

Ejemplo:

"game123"

world_id
string
requerido

El identificador único del mundo.

Ejemplo:

"world456"

character_id
string
requerido

El identificador único del personaje.

Ejemplo:

"character789"

Parámetros de consulta

session_id
string

(Opcional) El ID de sesión del jugador.

Ejemplo:

"60Z5aZjIuFlyYbjbZZKe"

Cuerpo

application/json

Los campos de datos del personaje a actualizar.

age
enum<string>

La categoría de edad del personaje.

Opciones disponibles:
infant,
child,
teenager,
youngAdult,
adult,
middleAged,
elderly
Ejemplo:

"adult"

description
string

Una breve descripción del personaje.

Ejemplo:

"Un valiente guerrero con un pasado misterioso."

gender
string

El género del personaje.

Ejemplo:

"Male"

model
enum<string>

El modelo de IA usado para las interacciones del personaje. Los modelos premium solo están disponibles para algunas suscripciones.

Opciones disponibles:
standard,
premium
Ejemplo:

"standard"

filters
object

Filtros de contenido estructurados aplicados a las respuestas del personaje. Indica los valores que deseas actualizar al ajustar la configuración de moderación.

Ejemplo:
items
object[]

Lista actualizada de objetos del personaje.

Esquema para objetos de tipo "trade"

events
object[]

Lista de eventos relacionados con el personaje.

Esquema para eventos de tipo "action"

name
string

El nombre visible del personaje.

Ejemplo:

"Aragorn"

quests
object[]

Una lista de misiones asociadas al personaje.

role
enum<string>

El rol que desempeña el personaje en el juego.

Opciones disponibles:
noRole,
protagonist,
antagonist,
secondaryCharacter,
tertiaryCharacter,
mentor,
enemy,
villain,
rival,
shopkeeper,
healer,
questGiver,
innkeeper,
guard,
familyMember,
loveInterest,
scientist,
politician,
criminal,
explorer,
wizard,
ghost,
animalCompanion,
artificialIntelligence
Ejemplo:

"protagonist"

tone
enum<string>

El estilo o estado de ánimo del diálogo del personaje.

Opciones disponibles:
formal,
casual,
sarcastic,
mysterious,
emotive
Ejemplo:

"mysterious"

traits
string[]

Lista legacy/de rasgos básicos. Si se envía sin personality_theory, la API guarda el personaje como basicTraits.

personality_theory
enum<string>
predeterminado:basicTraits

Marco de personalidad utilizado por interacciones.

Opciones disponibles:
basicTraits,
bigFive,
darkTriad,
dndAlignment,
mbti,
enneagram
Ejemplo:

"basicTraits"

personality_dimensions
object

Valores de dimensiones para el personality_theory seleccionado. basicTraits usa traits y un objeto vacío.

Ejemplo:
speech_pattern
object

Controles opcionales del estilo de habla consumidos por interacciones.

Respuesta

Personaje actualizado correctamente.

message
string

Mensaje de confirmación tras actualizar el personaje.

Ejemplo:

"Personaje: character789 ha sido actualizado con el siguiente contexto."

character_id
string

UID del personaje.

Ejemplo:

"character789"

character_context
object

Datos del contexto del personaje actualizados.

Ejemplo: