Spaces

Update a warehouse or space

Updates the record of a warehouse or space (send only the fields to change).

Tool

filmo_spaces_update

Writespaces:write

spaces:write
120/min
Server annotation: Idempotent

{
  "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
      }
    }
  }
}

generated from the schema

tags replaces the whole list, and a tag name that does not exist CREATES it. The holding costs of the space are NOT part of the public contract and cannot be written here; for the rate there is the pricing endpoint. If another space of the account already has that name (without distinguishing upper and lower case) or that internalReference, it responds 409 conflict with errors[0].path on the field. Returns the updated space in detail.

Arguments

spaceIdstringRequired

Space identifier.

Limits: min length 1

namestring

Space name.

Limits: min length 1

internalReferencestring | null

Internal reference, unique within the account; null clears it.

descriptionstring | null

Space description; null clears it.

buildingstring | null

Building the space belongs to; null clears it.

locationobject

Space location. Coordinates are required if the object is sent.

Show child attributes

location.addressstring

Street and number.

location.citystring

City.

location.postalCodestring

Postal code.

location.countrystring

Country.

location.latnumberRequired

Latitude in decimal degrees.

location.lngnumberRequired

Longitude in decimal degrees.

capacitynumber | null

Maximum capacity in people; null clears it.

Limits: min 0

dimensionsstring | null

Dimensions as free text; null clears it.

areanumber | null

Area in square metres; null clears it.

Limits: min 0

floornumber | null

Floor the space is on; null clears it.

isWarehouseboolean

true if it is a warehouse that manages stock; false if it is a rentable space.

tagsstring[]

Tags by identifier or by name; a name that does not exist CREATES the tag. Replaces the whole list.

collectionIdstring | null

Collection the space belongs to; null removes it from any collection.

Limits: min length 1

idempotencyKeystring

Idempotency key chosen by the client (a UUID is recommended). Repeating the same key with the same arguments within 24 h returns the stored response without executing again; with different arguments it responds 422. It is the safe way to retry after a network failure.

Limits: min length 1, max length 255

ifMatchstring

Optimistic locking: the meta.etag you got from the detail read of this resource (or "*"). If the resource changed since, the call fails with 412 precondition_failed before writing anything; read it again and retry. Omit it to write unconditionally.

Limits: min length 1

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

Show the attributes of data

idstring

Unique space identifier.

namestring

Space name.

internalReferencestring | null

Internal reference of the space, useful for matching with external systems; null if it has none.

isWarehouseboolean

true if the space is a warehouse that manages stock and can be the main warehouse of an order; false if it is a rentable space.

collectionIdstring | null

Identifier of the collection it belongs to; null if it is in none.

collectionNamestring | null

Full collection path, for example "Estudios > Fotografía"; null if not applicable.

buildingstring | null

Building it is located in; null if not applicable.

floornumber | null

Floor it is located on; null if not applicable.

locationobject

Physical location of the space.

Show child attributes

location.addressstring | null

Postal address; null if not recorded.

location.citystring | null

Municipality; null if not recorded.

location.postalCodestring | null

Postal code; null if not recorded.

location.countrystring | null

Country; null if not recorded.

location.latnumber | null

Latitude in decimal degrees; null if not geolocated.

location.lngnumber | null

Longitude in decimal degrees; null if not geolocated.

createdAtstring<date-time>

Creation date in ISO 8601 UTC.

updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

descriptionstring | null

Space description; null if it has none.

capacitynumber | null

Capacity in people; null if not defined.

areanumber | null

Area in square metres; null if not defined.

dimensionsstring | null

Dimensions as free text; null if not defined.

amenitiesstring[]

Additional services available (wifi, projector...).

equipmentsstring[]

Fixed equipment available in the space.

pricingSettingsobject | null

Rental pricing of the space; null if not configured. The same fields that PATCH /pricing accepts.

Show child attributes

pricingSettings.typestring | null

Pricing mode; null if not configured.

Available options: periodPrice, fixedPrice, pricingStructure

pricingSettings.pricestring | null

Base rental price as a decimal string; null if not configured.

Limits: pattern ^-?\d+\.\d{2}$

pricingSettings.periodstring | null

Period unit of the price; null if not configured.

Available options: hour, day, week, month

insuranceEnabledboolean

Whether the space allows insurance.

discountEnabledboolean

Whether the space allows a discount.

depositValuestring | null

Security deposit amount as a decimal string; null if not set.

Limits: pattern ^-?\d+\.\d{2}$

bufferBeforenumber | null

Time buffer reserved BEFORE the rental; null if none.

bufferBeforeUnitstring | null

Unit of the preceding buffer; null if none.

Available options: hour, day

bufferAfternumber | null

Time buffer reserved AFTER the rental; null if none.

bufferAfterUnitstring | null

Unit of the following buffer; null if none.

Available options: hour, day

customFieldsobject<string, any>

Custom field values by custom field identifier; the definitions are in /api/v1/custom-fields.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

The same operation by REST

This tool runs PATCH /api/v1/spaces/{spaceId}.

Spaces
Update a warehouse or space
Updates the record of a warehouse or space (send only the fields to change).
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Result

Arguments

Result

The same operation by REST

Related pages

Update a warehouse or space

Safe writes

Errors