Espacios

Actualizar un almacén o espacio

Actualiza el registro de un almacén o espacio (envía solo los campos que cambian).

Herramienta

filmo_spaces_update

Escrituraspaces:write

spaces:write
120/min
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_spaces_update",
    "arguments": {
      "spaceId": "spac_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "name": "Example",
      "internalReference": "<internalReference>",
      "isWarehouse": true,
      "collectionId": "coll_8f2a1c",
      "collectionName": "Example",
      "building": "<building>",
      "floor": 1,
      "location": {
        "address": "<address>",
        "city": "<city>",
        "postalCode": "<postalCode>",
        "country": "ES",
        "lat": 1,
        "lng": 1
      },
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z",
      "description": "<description>",
      "capacity": 1,
      "area": 1,
      "dimensions": "<dimensions>",
      "amenities": [
        "<amenities>"
      ],
      "equipments": [
        "<equipments>"
      ],
      "pricingSettings": {
        "type": "periodPrice",
        "price": "1234.50",
        "period": "hour"
      },
      "insuranceEnabled": true,
      "discountEnabled": true,
      "depositValue": "1234.50",
      "bufferBefore": 1,
      "bufferBeforeUnit": "hour",
      "bufferAfter": 1,
      "bufferAfterUnit": "hour",
      "customFields": {
        "key": "<key>"
      }
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

tags reemplaza la lista completa, y un nombre de etiqueta que no existe la CREA. Los costes de mantenimiento del espacio NO forman parte del contrato público y no se pueden escribir aquí; para la tarifa está el endpoint de precios. Si otro espacio de la cuenta ya tiene ese name (sin distinguir mayúsculas y minúsculas) o esa internalReference, responde 409 conflict con errors[0].path en el campo. Devuelve el espacio actualizado en detalle.

Argumentos

spaceIdstringObligatorio

Identificador del espacio.

Límites: longitud mín. 1

namestring

Nombre del espacio.

Límites: longitud mín. 1

internalReferencestring | null

Referencia interna, única dentro de la cuenta; null la borra.

descriptionstring | null

Descripción del espacio; null la borra.

buildingstring | null

Edificio al que pertenece el espacio; null lo borra.

locationobject

Ubicación del espacio. Las coordenadas son obligatorias si se envía el objeto.

Mostrar atributos hijos

location.addressstring

Calle y número.

location.citystring

Ciudad.

location.postalCodestring

Código postal.

location.countrystring

País.

location.latnumberObligatorio

Latitud en grados decimales.

location.lngnumberObligatorio

Longitud en grados decimales.

capacitynumber | null

Capacidad máxima en personas; null la borra.

Límites: mín. 0

dimensionsstring | null

Dimensiones en texto libre; null las borra.

areanumber | null

Superficie en metros cuadrados; null la borra.

Límites: mín. 0

floornumber | null

Planta en la que está el espacio; null la borra.

isWarehouseboolean

true si es un almacén que gestiona stock; false si es un espacio alquilable.

tagsstring[]

Etiquetas por identificador o por nombre; un nombre que no existe CREA la etiqueta. Reemplaza la lista completa.

collectionIdstring | null

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

Límites: longitud mín. 1

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 espacio.

namestring

Nombre del espacio.

internalReferencestring | null

Referencia interna del espacio, útil para casarla con sistemas externos; null si no tiene.

isWarehouseboolean

true si el espacio es un almacén que gestiona stock y puede ser el almacén principal de un pedido; false si es un espacio alquilable.

collectionIdstring | null

Identificador de la colección a la que pertenece; null si no está en ninguna.

collectionNamestring | null

Ruta completa de la colección, por ejemplo "Estudios > Fotografía"; null si no aplica.

buildingstring | null

Edificio en el que se encuentra; null si no aplica.

floornumber | null

Planta en la que se encuentra; null si no aplica.

locationobject

Ubicación física del espacio.

Mostrar atributos hijos

location.addressstring | null

Dirección postal; null si no se ha registrado.

location.citystring | null

Municipio; null si no está registrado.

location.postalCodestring | null

Código postal; null si no se ha registrado.

location.countrystring | null

País; null si no consta.

location.latnumber | null

Latitud en grados decimales; null si no está geolocalizado.

location.lngnumber | null

Longitud en grados decimales; null si no está geolocalizado.

createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

updatedAtstring<date-time>

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

descriptionstring | null

Descripción del espacio; null si no tiene.

capacitynumber | null

Capacidad en personas; null si no está definida.

areanumber | null

Superficie en metros cuadrados; null si no está definida.

dimensionsstring | null

Dimensiones en texto libre; null si no están definidas.

amenitiesstring[]

Servicios adicionales disponibles (wifi, proyector...).

equipmentsstring[]

Equipamiento fijo disponible en el espacio.

pricingSettingsobject | null

Precios de alquiler del espacio; null si no está configurado. Los mismos campos que acepta PATCH /pricing.

Mostrar atributos hijos

pricingSettings.typestring | null

Modo de precio; null si no está configurado.

Opciones disponibles: periodPrice, fixedPrice, pricingStructure

pricingSettings.pricestring | null

Precio base de alquiler como cadena decimal; null si no está configurado.

Límites: patrón ^-?\d+\.\d{2}$

pricingSettings.periodstring | null

Unidad de periodo del precio; null si no está configurada.

Opciones disponibles: hour, day, week, month

insuranceEnabledboolean

Si el espacio admite seguro.

discountEnabledboolean

Si el espacio admite descuento.

depositValuestring | null

Importe de la fianza como cadena decimal; null si no está definido.

Límites: patrón ^-?\d+\.\d{2}$

bufferBeforenumber | null

Margen de tiempo reservado ANTES del alquiler; null si no hay.

bufferBeforeUnitstring | null

Unidad del margen previo; null si no hay.

Opciones disponibles: hour, day

bufferAfternumber | null

Margen de tiempo reservado DESPUÉS del alquiler; null si no hay.

bufferAfterUnitstring | null

Unidad del margen posterior; null si no hay.

Opciones disponibles: hour, day

customFieldsobject<string, any>

Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en /api/v1/custom-fields.

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/spaces/{spaceId}.

Espacios
Actualizar un almacén o espacio
Actualiza el registro de un almacén o espacio (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?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Actualizar un almacén o espacio

Escrituras seguras

Errores