Kits

Actualizar un kit

Actualiza un kit (envía solo los campos que cambian).

Herramienta
filmo_kits_update
Acceso: Escritura

Resultado

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_kits_update",
    "arguments": {
      "kitId": "kit_8f2a1c"
    }
  }
}

generado desde el esquema

tags reemplaza la lista completa. Devuelve el kit actualizado.

Argumentos

kitIdstringObligatorio

Identificador del kit.

Límites: longitud mín. 1

namestring

Nombre del kit.

Límites: longitud mín. 1

descriptionstring | null

Descripción del kit; null la borra.

imagestring | null

URL de la imagen principal; null la borra.

collectionIdstring | null

Colección a la que pertenece; null lo saca de cualquier colección.

Límites: longitud mín. 1

tagsstring[]

Etiquetas por NOMBRE; un nombre que no existe se crea.

idempotencyKeystring

Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.

Límites: longitud mín. 1, longitud máx. 255

ifMatchstring

Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.

Límites: longitud mín. 1

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data
idstring

Identificador único del kit.

namestring

Nombre del kit.

descriptionstring | null

Descripción del kit; null si no tiene.

imagestring | null

URL de la imagen principal; null si no tiene.

collectionIdstring | null

Colección a la que pertenece; null si no está en ninguna.

collectionNamestring | null

Ruta completa de la colección; null si no está en ninguna.

tagsobject[]

Etiquetas del kit, con su identificador y nombre.

Mostrar atributos hijos
tags.idstring

Identificador único de la etiqueta.

tags.namestring

Nombre de la etiqueta.

componentsobject[]

Artículos que componen el kit, en orden de visualización.

Mostrar atributos hijos
components.itemIdstring

Identificador del artículo; consúltalo en /api/v1/items/{itemId}.

components.itemNamestring

Nombre del artículo, tal como se registró al añadirlo al kit.

components.variantIdstring | null

Variante del artículo, si se eligió una; null en caso contrario.

components.variantNamestring | null

Nombre de esa variante; null si no hay.

components.quantitynumber

Cuántas unidades del artículo incluye el kit.

components.positionnumber | null

Orden de visualización dentro del kit (base 0); null si no está definido.

createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

updatedAtstring<date-time>

Fecha de la última modificación en ISO 8601 UTC.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta PATCH /api/v1/kits/{kitId}.

  • Kits

    Actualizar un kit

    Actualiza un kit (envía solo los campos que cambian).

  • Guías

    Escrituras seguras

    Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.

  • Guías

    Errores

    Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?