Spaces

Replace the amenities and equipment

Fully REPLACES the two lists of the space: the amenities offered with it (wifi, 24/7 access, parking) and the physical equipment delivered with it (projector, whiteboard, sound).

Tool

filmo_spaces_amenities_replace

Destructivespaces:write

spaces:write
120/min
Server annotation: Destructive
Server annotation: Idempotent
Requires human confirmation

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_spaces_amenities_replace",
    "arguments": {
      "spaceId": "spac_8f2a1c",
      "commodities": [
        "<commodities>"
      ],
      "amenities": [
        "<amenities>"
      ]
    }
  }
}

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

Requires human confirmation

Put this tool on your client's “ask before running” list. The annotations are hints that the server declares, not guarantees: do not decide the approval from destructiveHint alone.

It is PUT and not PATCH because both lists are replaced whole: always send both, including the one that does not change. Returns the updated space in detail.

Arguments

spaceIdstringRequired

Space identifier.

Limits: min length 1

commoditiesstring[]Required

Services offered with the space (wifi, 24/7 access, parking...). REPLACES the whole list.

amenitiesstring[]Required

Physical equipment delivered with the space (projector, whiteboard, sound...). REPLACES the whole list.

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 PUT /api/v1/spaces/{spaceId}/amenities.

Spaces
Replace the amenities and equipment
Fully REPLACES the two lists of the space: the amenities offered with it (wifi, 24/7 access, parking) and the physical equipment delivered with it (projector, whiteboard, sound).
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

Replace the amenities and equipment

Safe writes

Errors