Errors

`validation_error`

400. The query or the body is malformed, or it refers to an identifier that does not exist or does not belong to the account (the message is the same in both cases, so it cannot be used to probe other accounts). errors lists every offending field, not only the first, and nothing is written. HTTP 400.

HTTP status: 400
Problem type: https://docs.filmo.io/errors/validation_error

{
  "type": "https://docs.filmo.io/errors/validation_error",
  "title": "Validation error",
  "status": 400,
  "code": "validation_error",
  "detail": "2 validation errors",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "name",
      "code": "too_small",
      "message": "Must be at least 1 characters long"
    },
    {
      "path": "contactType",
      "code": "invalid_value",
      "message": "Value not allowed; expected company, person"
    }
  ]
}

When it happens

What to do

Read every entry of errors: path says which field and code says what is wrong. Correct all of them, then send the request again. Branch on code, never on message or detail, which are written for people and change with the language.

Retry

Fix and resendAny validation 4xx
Fix the request and resend it; never in a loop.

Fields of errors[]

errors[].pathstring

Path of the offending field in dot and bracket notation (lines[0].itemId); empty for the whole body. On contact_in_use, address_in_use and insufficient_stock it is one of a closed set, listed by code in x-path-values: the type of record that uses the contact or the address, or the kind of resource that is short (items or spaces).

errors[].codestring

Stable code of the field error (required, must_not_be_null, invalid_type, invalid_value, too_small, too_big, unknown_field, invalid_format, not_found, must_be_after…). On a 409 conflict it says the cause: in_progress (another request with the same Idempotency-Key is still running), lock_timeout (another conditional write held the resource for more than five seconds) or invalid_state (the state of the resource forbids the operation).

errors[].messagestring

Localized explanation, in the negotiated language.

Returned by

122 operations

GET /api/v1/contacts — List contacts
POST /api/v1/contacts — Create a contact
PATCH /api/v1/contacts/{contactId} — Update 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
POST /api/v1/contacts/{contactId}/related-contacts — Relate two contacts
PATCH /api/v1/contacts/{contactId}/related-contacts/{relatedContactId} — Change the role of a relationship
GET /api/v1/items — List items
POST /api/v1/items — Create an item
PATCH /api/v1/items/{itemId} — Update 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/availability/check — Check item availability
GET /api/v1/orders — List orders
POST /api/v1/orders — Create an order
PATCH /api/v1/orders/{orderId} — Update the header of an order
GET /api/v1/orders/{orderId}/lines — List the lines of an order
GET /api/v1/invoices — List invoices
GET /api/v1/quotes — List quotes
GET /api/v1/projects — List projects
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
GET /api/v1/invoices/{invoiceId}/payments — List the payments of an invoice
GET /api/v1/invoices/{invoiceId}/lines — List the lines of an invoice
GET /api/v1/quotes/{quoteId}/lines — List the lines of a quote
GET /api/v1/serialized-items — List serialized items
PATCH /api/v1/serialized-items/{serializedItemId} — Update a serialized item
GET /api/v1/spaces — List warehouses and spaces
PATCH /api/v1/spaces/{spaceId} — Update a warehouse or space
PUT /api/v1/spaces/{spaceId}/amenities — Replace the amenities and equipment
PATCH /api/v1/spaces/{spaceId}/pricing — Update the pricing of a space
GET /api/v1/repair-tickets — List repair tickets
POST /api/v1/repair-tickets — Create a repair ticket
PATCH /api/v1/repair-tickets/{ticketId} — Update a repair ticket
GET /api/v1/vehicles — List vehicles
POST /api/v1/vehicles — Create a vehicle
PATCH /api/v1/vehicles/{vehicleId} — Update a vehicle
GET /api/v1/staff — List staff
POST /api/v1/staff — Create a staff member
PATCH /api/v1/staff/{staffId} — Update a staff member
GET /api/v1/subrents — List subrents
PATCH /api/v1/subrents/{subrentId} — Update a subrent
GET /api/v1/purchase-orders — List purchase orders
PATCH /api/v1/purchase-orders/{purchaseOrderId} — Update a purchase order
GET /api/v1/contracts — List contracts
GET /api/v1/project-types — List project types
POST /api/v1/staff/availability — Check staff availability
POST /api/v1/vehicles/availability — Check fleet availability
GET /api/v1/custom-fields — List custom field definitions
GET /api/v1/tags — List tags
POST /api/v1/tags — Create a tag
POST /api/v1/tags/{tagId}/assignments — Assign a tag to an entity
DELETE /api/v1/tags/{tagId}/assignments — Remove a tag from an entity
GET /api/v1/kits — List kits
POST /api/v1/kits — Create a kit
PATCH /api/v1/kits/{kitId} — Update a kit
GET /api/v1/collections — List collections
POST /api/v1/collections — Create a collection
PATCH /api/v1/collections/{collectionId} — Update a collection
GET /api/v1/services — List services
POST /api/v1/services — Create a service
PATCH /api/v1/services/{serviceId} — Update a service
GET /api/v1/internal-services — List internal services
POST /api/v1/internal-services — Create an internal service
PATCH /api/v1/internal-services/{internalServiceId} — Update an internal service
GET /api/v1/planner/services — List the services to cover
POST /api/v1/planner/assignments — Assign a resource to a service
POST /api/v1/planner/assignments/remove — Remove a resource from a service
GET /api/v1/schedule — Get the schedule for a range
GET /api/v1/availability/unavailabilities — List the unavailabilities of a resource
POST /api/v1/availability/unavailabilities — Declare an unavailability
PATCH /api/v1/availability/unavailabilities/{unavailabilityId} — Correct or close an unavailability
GET /api/v1/incidents — List incidents
POST /api/v1/incidents — Open an incident
PATCH /api/v1/incidents/{incidentId} — Update an incident
GET /api/v1/incidents/status-counts — Count incidents by status
POST /api/v1/incidents/{incidentId}/comments — Comment on an incident
GET /api/v1/notes — List the notes of an entity
POST /api/v1/notes — Write a note on an entity
GET /api/v1/tasks — List tasks
POST /api/v1/tasks — Create a task
PATCH /api/v1/tasks/{taskId} — Update a task
GET /api/v1/task-types — List task types
GET /api/v1/crm/opportunities — List opportunities
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
GET /api/v1/crm/pipelines — List pipelines
POST /api/v1/purchase-orders/{purchaseOrderId}/receive — Receive material from a purchase order
GET /api/v1/supplier-invoices — List supplier invoices
GET /api/v1/treasury/accounts — List treasury accounts
GET /api/v1/treasury/payments — List treasury payments
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
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
GET /api/v1/planner/resources — List the assignable resources
GET /api/v1/credit-notes — List credit notes
GET /api/v1/proformas — List proformas
POST /api/v1/contacts/lookup — Look up contacts by external reference
POST /api/v1/orders/line-items/returns — Return order lines
POST /api/v1/ai/ask — Ask the AI about your data
GET /api/v1/workflows — List workflows
POST /api/v1/workflows/{workflowId}/runs — Run a workflow
POST /api/v1/invoices/{invoiceId}/void — Void an invoice
PUT /api/v1/invoices/external/{originSystem}/{originExternalId} — Create or update the mirror of an externally issued invoice
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}/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}/void — Void a supplier invoice
GET /api/v1/payment-methods — List payment methods
GET /api/v1/users — List users

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