Items

Update a serialized item

Changes the record of ONE serialized item: its status, where it is, its serial number or its warranty.

Tool

filmo_serialized_items_update

Writeitems:write

items:write
120/min
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_serialized_items_update",
    "arguments": {
      "serializedItemId": "seri_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "code": "<code>",
      "serialNumber": "<serialNumber>",
      "status": "<status>",
      "itemId": "item_8f2a1c",
      "itemName": "Example",
      "itemSku": "<itemSku>",
      "itemCollectionName": "Example",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

It is what a warehouse system needs to say "this one is back and operational". What the unit cost, the internal note and the subrent terms neither go in nor come out through this API. The item it belongs to is resolved by the server. Returns the full serialized item, the same projection as its GET.

Arguments

serializedItemIdstringRequired

Serialized item identifier.

Limits: min length 1

codestring

Internal code of the unit. It identifies the unit, so it cannot be empty.

Limits: min length 1, max length 200

serialNumberstring | null

Manufacturer serial number; null clears it.

Limits: max length 200

statusstring

Unit status.

Available options: available, prepared, picked_up, returned, broken, archived, sold

activeboolean

false removes the unit from the pool without deleting it.

orderInfostring

Information visible on the order and on the delivery note.

Limits: max length 1000

providerReferencestring

Reference by which the supplier identifies the unit.

Limits: max length 200

poNumberstring

Number of the purchase order that brought it in.

Limits: max length 200

purchaseDatestring<date-time>

Purchase date, in ISO 8601 with offset.

warrantyExpirationstring<date-time>

Warranty end, in ISO 8601 with offset.

spaceIdstring

Warehouse where the unit is located.

locationIdstring | null

Location within the warehouse; null clears it.

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 identifier of the physical unit.

codestring

Internal code of the unit.

serialNumberstring | null

Manufacturer serial number; null if not registered.

statusstring

Current status of the unit within the inventory cycle.

itemIdstring

Identifier of the catalog item this unit belongs to.

itemNamestring

Name of the catalog item.

itemSkustring | null

SKU of the item; null if it has none.

itemCollectionNamestring | null

Name of the collection of the item; null if it is in none.

createdAtstring<date-time> | null

Creation date in ISO 8601 UTC; null if not recorded.

updatedAtstring<date-time> | null

Last modification date in ISO 8601 UTC; null if not recorded.

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/serialized-items/{serializedItemId}.

Items
Update a serialized item
Changes the record of ONE serialized item: its status, where it is, its serial number or its warranty.
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 serialized item

Safe writes

Errors