> ## Documentation Index
> Fetch the complete documentation index at: https://docs.npcbuilder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar detalles del mundo

> Actualiza los detalles de un mundo existente. Modifica campos como trasfondo, nombre, criaturas y mundos similares.




## OpenAPI

````yaml /es/api-reference/openapi.yaml patch /context/world/{game_id}/{world_id}
openapi: 3.0.3
info:
  title: NPC Builder - API
  description: >
    Esta es la especificación más reciente de la API de NPC Builder que define
    una API integral y lista para producción para NPC Builder. La API se divide
    en tres servicios principales:


    **Servicio de Interacciones**  
      - **Propósito:** Permite conversaciones dinámicas y con conciencia de contexto entre jugadores y personajes NPC.


    **Servicio de Contexto**  
      - **Propósito:** Gestiona entidades del juego para construir y mantener entornos inmersivos.
      - **Incluye:**  
        - **Mundos:** Crear, actualizar y eliminar mundos del juego.
        - **Regiones:** Definir y gestionar regiones dentro de un mundo.
        - **Localizaciones:** Gestionar ubicaciones específicas dentro de las regiones.
        - **Personajes:** Gestionar el ciclo de vida (creación, actualización, eliminación) de personajes NPC.


    **Servicio de Sesiones**  
      - **Propósito:** Gestiona sesiones de jugadores para mantener el contexto del juego y rastrear interacciones.


    En conjunto, esta especificación sirve como una guía detallada para
    aprovechar los servicios de NPC Builder—permitiendo a los desarrolladores
    crear experiencias ricas e interactivas mientras gestionan de forma
    eficiente contextos y entidades del juego.
        _Debes ceñirte a la estructura de datos definida; de lo contrario puedes encontrar errores no controlados_


    **Consulta los esquemas de cada solicitud para encontrar los valores
    permitidos de ciertas propiedades.**


    _Limitaciones técnicas: La actualización y eliminación del conocimiento y
    las relaciones de los personajes no están disponibles a través de la API.
    Deben gestionarse desde el frontend de nuestra aplicación._


    Algunos enlaces útiles:

    - [Nuestro sitio web](https://npcbuilder.com)

    - [La app](https://app.npcbuilder.com)
  termsOfService: https://npcbuilder.com/terms-and-conditions/
  contact:
    email: support@npcbuilder.com
  version: 1.6.0
servers:
  - url: https://app.npcbuilder.com/api
    description: >-
      API de producción para contexto, sesiones y endpoints que no son de
      interacciones
security: []
tags:
  - name: Interactions
    description: >-
      Gestiona las conversaciones de texto de tus NPCs y sus respuestas
      interactivas.
  - name: Characters
    description: >-
      Gestiona personajes de tu juego, incluyendo creación, actualización y
      eliminación.
  - name: Worlds
    description: Crea y gestiona mundos inmersivos para tu juego.
  - name: Regions
    description: Define y gestiona regiones dentro de tus mundos.
  - name: Locations
    description: Gestiona ubicaciones específicas dentro de las regiones de tu juego.
  - name: Sessions
    description: >-
      Crea, recupera y elimina sesiones de jugadores para una mejor gestión del
      juego.
paths:
  /context/world/{game_id}/{world_id}:
    patch:
      tags:
        - Worlds
      summary: Actualizar detalles del mundo
      description: >
        Actualiza los detalles de un mundo existente. Modifica campos como
        trasfondo, nombre, criaturas y mundos similares.
      parameters:
        - name: game_id
          in: path
          required: true
          description: El identificador único del juego.
          schema:
            type: string
            example: game123
        - name: world_id
          in: path
          required: true
          description: El identificador único del mundo.
          schema:
            type: string
            example: world456
        - name: session_id
          in: query
          description: (Opcional) El ID de sesión del jugador.
          required: false
          schema:
            type: string
            example: 60Z5aZjIuFlyYbjbZZKe
      requestBody:
        required: true
        description: Los campos del mundo que se van a actualizar.
        content:
          application/json:
            schema:
              type: object
              properties:
                lore:
                  type: string
                  description: Trasfondo actualizado del mundo.
                  example: Un mundo donde la magia y la tecnología coexisten.
                name:
                  type: string
                  description: Nombre actualizado del mundo.
                  example: Eldoria
                creatures:
                  type: string
                  description: Lista actualizada de criaturas.
                  example: Dragons, Elves
                similarWorlds:
                  type: array
                  description: Lista actualizada de mundos similares.
                  items:
                    type: string
                    example: Middle Earth
      responses:
        '200':
          description: Mundo actualizado correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Mensaje de confirmación tras actualizar el mundo.
                    example: >-
                      Mundo: world456 ha sido actualizado con el siguiente
                      contexto.
                  world_id:
                    type: string
                    description: UID del mundo.
                    example: world456
                  world_context:
                    type: object
                    description: Detalles del contexto del mundo creado.
                    example:
                      lore: Un mundo donde la magia y la tecnología coexisten.
                      name: Eldoria
                      creatures: Dragons, Elves
                      similarWorlds:
                        - Middle Earth
        '400':
          description: >
            Error de validación – La carga útil de la solicitud no cumple el
            esquema requerido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: |
            No encontrado – No se encontró el mundo especificado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Mensaje de error con posibles razones.
                    example: |
                      Posibles razones:
                      - Mundo con ID [...] no encontrado
        '500':
          description: >
            Error interno del servidor – Ocurrió un error al actualizar el
            mundo.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - npcbuilder_auth: []
components:
  schemas:
    ErrorResponse:
      type: object
      description: Esquema estándar de respuesta de error.
      properties:
        message:
          type: string
          description: Mensaje de error detallado.
          example: Ocurrió un error
  securitySchemes:
    npcbuilder_auth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````