Spaces

Update the pricing of a space

Sets the rental rate of the space, the deposit, whether it allows insurance and discount, and the time margins that block it around the booking.

Tool

filmo_spaces_update_pricing

Writespaces:write

spaces:write
120/min
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_spaces_update_pricing",
    "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

The internal cost, the external cost and the tax configuration are NOT part of the public contract. Note: the public record of a space does not emit its commercial policy, so what you write here cannot be read back through the API. Returns the updated space in detail.

Arguments

spaceIdstringRequired

Space identifier.

Limits: min length 1

pricingSettingsobject | null

Rental pricing of the space, the three fields together; null clears it.

Show child attributes

pricingSettings.typestringRequired

Pricing mode.

Available options: periodPrice, fixedPrice, pricingStructure

pricingSettings.pricestringRequired

Base rental price, as a decimal string.

Limits: pattern ^\d{1,13}(\.\d{1,2})?$

pricingSettings.periodstringRequired

Period unit of the price.

Available options: hour, day, week, month

insuranceEnabledboolean

Whether the space allows insurance.

depositValuestring | null

Security deposit amount, as a decimal string; null clears it.

Limits: pattern ^\d{1,13}(\.\d{1,2})?$

discountEnabledboolean

Whether the space allows a discount.

bufferBeforenumber | null

Time buffer reserved BEFORE the rental; null clears it together with its unit.

Limits: min 0

bufferBeforeUnitstring | null

Unit of the preceding buffer; null only together with bufferBefore: null.

Available options: hour, day

bufferAfternumber | null

Time buffer reserved AFTER the rental; null clears it together with its unit.

Limits: min 0

bufferAfterUnitstring | null

Unit of the following buffer; null only together with bufferAfter: null.

Available options: hour, day

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}/pricing.

Spaces
Update the pricing of a space
Sets the rental rate of the space, the deposit, whether it allows insurance and discount, and the time margins that block it around the booking.
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 the pricing of a space

Safe writes

Errors