Errors

`precondition_failed`

412. The If-Match entity tag you sent does not match the current one: the resource changed since you read it. The write was rejected before doing anything. HTTP 412.

HTTP status: 412
Problem type: https://docs.filmo.io/errors/precondition_failed

{
  "type": "https://docs.filmo.io/errors/precondition_failed",
  "title": "Precondition failed",
  "status": 412,
  "code": "precondition_failed",
  "detail": "The resource changed since you read it: read it again and retry",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

When it happens

412. The If-Match entity tag you sent does not match the current one: the resource changed since you read it. The write was rejected before doing anything.

What to do

Read the resource again, redo your change on top of the fresh state, and send it with the new ETag. Do not resend the old body with the new tag without looking at what changed.

Retry

Read the resource first412 precondition_failed
Read the resource again, redo your change on top of it and send the new ETag.

Returned by

78 operations

POST /api/v1/contacts — Create a contact
PATCH /api/v1/contacts/{contactId} — Update a contact
DELETE /api/v1/contacts/{contactId} — Delete a contact
PATCH /api/v1/contacts/{contactId}/preferences — Update the commercial terms of a contact
POST /api/v1/contacts/{contactId}/addresses — Add an address to a contact
PATCH /api/v1/contacts/{contactId}/addresses/{addressId} — Update an address of a contact
DELETE /api/v1/contacts/{contactId}/addresses/{addressId} — Remove an address from a contact
POST /api/v1/contacts/{contactId}/related-contacts — Relate two contacts
PATCH /api/v1/contacts/{contactId}/related-contacts/{relatedContactId} — Change the role of a relationship
DELETE /api/v1/contacts/{contactId}/related-contacts/{relatedContactId} — Unrelate two contacts
POST /api/v1/items — Create an item
PATCH /api/v1/items/{itemId} — Update an item
DELETE /api/v1/items/{itemId} — Delete an item
PATCH /api/v1/items/{itemId}/physical-properties — Update weight and dimensions
PATCH /api/v1/items/{itemId}/pricing — Update the pricing of an item
POST /api/v1/orders — Create an order
PATCH /api/v1/orders/{orderId} — Update the header of an order
POST /api/v1/projects — Create a project
PUT /api/v1/projects/{projectId}/archive — Archive or restore a project
PATCH /api/v1/projects/{projectId} — Update a project
PATCH /api/v1/serialized-items/{serializedItemId} — Update a serialized item
PATCH /api/v1/spaces/{spaceId} — Update a warehouse or space
DELETE /api/v1/spaces/{spaceId} — Delete a space
PUT /api/v1/spaces/{spaceId}/amenities — Replace the amenities and equipment
PATCH /api/v1/spaces/{spaceId}/pricing — Update the pricing of a space
POST /api/v1/repair-tickets — Create a repair ticket
PATCH /api/v1/repair-tickets/{ticketId} — Update a repair ticket
POST /api/v1/vehicles — Create a vehicle
PATCH /api/v1/vehicles/{vehicleId} — Update a vehicle
DELETE /api/v1/vehicles/{vehicleId} — Delete a vehicle
POST /api/v1/staff — Create a staff member
PATCH /api/v1/staff/{staffId} — Update a staff member
DELETE /api/v1/staff/{staffId} — Delete a staff member
PATCH /api/v1/subrents/{subrentId} — Update a subrent
PATCH /api/v1/purchase-orders/{purchaseOrderId} — Update a purchase order
POST /api/v1/kits — Create a kit
PATCH /api/v1/kits/{kitId} — Update a kit
POST /api/v1/services — Create a service
PATCH /api/v1/services/{serviceId} — Update a service
POST /api/v1/internal-services — Create an internal service
PATCH /api/v1/internal-services/{internalServiceId} — Update an internal service
POST /api/v1/incidents — Open an incident
PATCH /api/v1/incidents/{incidentId} — Update an incident
POST /api/v1/incidents/{incidentId}/comments — Comment on an incident
POST /api/v1/tasks — Create a task
PATCH /api/v1/tasks/{taskId} — Update a task
DELETE /api/v1/tasks/{taskId} — Delete a task
POST /api/v1/crm/opportunities — Create an opportunity
PATCH /api/v1/crm/opportunities/{opportunityId} — Update an opportunity
PATCH /api/v1/crm/opportunities/{opportunityId}/stage — Move an opportunity to another stage
POST /api/v1/crm/opportunities/{opportunityId}/close — Close an opportunity
POST /api/v1/crm/opportunities/{opportunityId}/links — Link a document to an opportunity
POST /api/v1/purchase-orders/{purchaseOrderId}/approve — Approve a purchase order
POST /api/v1/purchase-orders/{purchaseOrderId}/receive — Receive material from a purchase order
POST /api/v1/treasury/payments — Record an incoming or outgoing payment
PATCH /api/v1/treasury/payments/{paymentId} — Update a payment
POST /api/v1/treasury/payments/{paymentId}/links — Link a payment to a document
POST /api/v1/orders/{orderId}/cancel — Cancel an order
PUT /api/v1/orders/{orderId}/archive — Archive or restore an order
PUT /api/v1/items/{itemId}/accessories — Update the accessories of an item
PUT /api/v1/items/{itemId}/alternatives — Update the alternatives of an item
PATCH /api/v1/items/{itemId}/variants/{variantId} — Update a variant of an item
POST /api/v1/orders/{orderId}/reserve — Reserve an order
POST /api/v1/orders/{orderId}/unreserve — Unreserve an order
POST /api/v1/projects/{projectId}/orders/{orderId} — Link an order to a project
DELETE /api/v1/projects/{projectId}/orders/{orderId} — Unlink an order from a project
POST /api/v1/invoices/{invoiceId}/validate — Validate an invoice
POST /api/v1/invoices/{invoiceId}/void — Void an invoice
POST /api/v1/credit-notes/{creditNoteId}/validate — Validate a credit note
POST /api/v1/credit-notes/{creditNoteId}/void — Void a credit note
PATCH /api/v1/proformas/{proformaId}/status — Change the commercial status of a proforma
PATCH /api/v1/quotes/{quoteId}/status — Change the commercial status of a quote
POST /api/v1/contracts/{contractId}/validate — Validate a contract
POST /api/v1/contracts/{contractId}/sign — Record the signature of a contract
POST /api/v1/contracts/{contractId}/void — Void a contract
POST /api/v1/contracts/{contractId}/cancel — Cancel a contract operatively
POST /api/v1/supplier-invoices/{supplierInvoiceId}/validate — Validate a supplier invoice
POST /api/v1/supplier-invoices/{supplierInvoiceId}/void — Void a supplier invoice

Through MCP

A tool call that fails comes back with `isError` set and the problem as structured content, with the same `code`.

Was this page helpful?

Example

When it happens

What to do

Retry

Returned by

Through MCP