Errores

`validation_error`

400. La consulta o el cuerpo están mal formados, o se refieren a un identificador que no existe o que no pertenece a la cuenta (el mensaje es el mismo en ambos casos, así que no sirve para sondear otras cuentas). errors lista todos los campos incorrectos, no solo el primero, y no se escribe nada. HTTP 400.

Estado HTTP: 400
Tipo del problema: 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"
    }
  ]
}

Cuándo ocurre

Qué hacer

Lee cada entrada de errors: path indica qué campo y code indica qué falla. Corrígelas todas y vuelve a enviar la petición. Decide según code, nunca según message ni detail, que están escritos para personas y cambian con el idioma.

Reintento

Corregir y reenviarCualquier 4xx de validación
Corrige la petición y reenvíala; nunca en bucle.

Campos de errors[]

errors[].pathstring

Ruta del campo erróneo en notación de puntos y corchetes (lines[0].itemId); vacía si afecta a todo el cuerpo. En contact_in_use, address_in_use e insufficient_stock es uno de un conjunto cerrado, listado por código en x-path-values: el tipo de registro que usa el contacto o la dirección, o la clase de recurso que escasea (items o spaces).

errors[].codestring

Código estable del error de campo (required, must_not_be_null, invalid_type, invalid_value, too_small, too_big, unknown_field, invalid_format, not_found, must_be_after…). En un 409 conflict indica la causa: in_progress (otra petición con la misma Idempotency-Key sigue en curso), lock_timeout (otra escritura condicional retuvo el recurso durante más de cinco segundos) o invalid_state (el estado del recurso prohíbe la operación).

errors[].messagestring

Explicación localizada, en el idioma negociado.

Lo devuelven

122 operaciones

GET /api/v1/contacts — Listar contactos
POST /api/v1/contacts — Crear un contacto
PATCH /api/v1/contacts/{contactId} — Actualizar un contacto
PATCH /api/v1/contacts/{contactId}/preferences — Actualizar las condiciones comerciales de un contacto
POST /api/v1/contacts/{contactId}/addresses — Añadir una dirección a un contacto
PATCH /api/v1/contacts/{contactId}/addresses/{addressId} — Actualizar una dirección de un contacto
POST /api/v1/contacts/{contactId}/related-contacts — Relacionar dos contactos
PATCH /api/v1/contacts/{contactId}/related-contacts/{relatedContactId} — Cambiar el rol de una relación
GET /api/v1/items — Listar artículos
POST /api/v1/items — Crear un artículo
PATCH /api/v1/items/{itemId} — Actualizar un artículo
PATCH /api/v1/items/{itemId}/physical-properties — Actualizar peso y dimensiones
PATCH /api/v1/items/{itemId}/pricing — Actualizar los precios de un artículo
POST /api/v1/availability/check — Comprobar la disponibilidad de artículos
GET /api/v1/orders — Listar pedidos
POST /api/v1/orders — Crear un pedido
PATCH /api/v1/orders/{orderId} — Actualizar la cabecera de un pedido
GET /api/v1/orders/{orderId}/lines — Listar las líneas de un pedido
GET /api/v1/invoices — Listar facturas
GET /api/v1/quotes — Listar presupuestos
GET /api/v1/projects — Listar proyectos
POST /api/v1/projects — Crear un proyecto
PUT /api/v1/projects/{projectId}/archive — Archivar o restaurar un proyecto
PATCH /api/v1/projects/{projectId} — Actualizar un proyecto
GET /api/v1/invoices/{invoiceId}/payments — Listar los pagos de una factura
GET /api/v1/invoices/{invoiceId}/lines — Listar las líneas de una factura
GET /api/v1/quotes/{quoteId}/lines — Listar las líneas de un presupuesto
GET /api/v1/serialized-items — Listar unidades serializadas
PATCH /api/v1/serialized-items/{serializedItemId} — Actualizar una unidad serializada
GET /api/v1/spaces — Listar almacenes y espacios
PATCH /api/v1/spaces/{spaceId} — Actualizar un almacén o espacio
PUT /api/v1/spaces/{spaceId}/amenities — Reemplazar las comodidades y el equipamiento
PATCH /api/v1/spaces/{spaceId}/pricing — Actualizar los precios de un espacio
GET /api/v1/repair-tickets — Listar tickets de reparación
POST /api/v1/repair-tickets — Crear un parte de reparación
PATCH /api/v1/repair-tickets/{ticketId} — Actualizar un ticket de reparación
GET /api/v1/vehicles — Listar vehículos
POST /api/v1/vehicles — Crear un vehículo
PATCH /api/v1/vehicles/{vehicleId} — Actualizar un vehículo
GET /api/v1/staff — Listar personal
POST /api/v1/staff — Crear un miembro del personal
PATCH /api/v1/staff/{staffId} — Actualizar un miembro del personal
GET /api/v1/subrents — Listar subalquileres
PATCH /api/v1/subrents/{subrentId} — Actualizar un subalquiler
GET /api/v1/purchase-orders — Listar pedidos de compra
PATCH /api/v1/purchase-orders/{purchaseOrderId} — Actualizar una orden de compra
GET /api/v1/contracts — Listar contratos
GET /api/v1/project-types — Listar tipos de proyecto
POST /api/v1/staff/availability — Comprobar la disponibilidad del personal
POST /api/v1/vehicles/availability — Comprobar la disponibilidad de la flota
GET /api/v1/custom-fields — Listar definiciones de campos personalizados
GET /api/v1/tags — Listar etiquetas
POST /api/v1/tags — Crear una etiqueta
POST /api/v1/tags/{tagId}/assignments — Asignar una etiqueta a una entidad
DELETE /api/v1/tags/{tagId}/assignments — Quitar una etiqueta de una entidad
GET /api/v1/kits — Listar kits
POST /api/v1/kits — Crear un kit
PATCH /api/v1/kits/{kitId} — Actualizar un kit
GET /api/v1/collections — Listar colecciones
POST /api/v1/collections — Crear una colección
PATCH /api/v1/collections/{collectionId} — Actualizar una colección
GET /api/v1/services — Listar servicios
POST /api/v1/services — Crear un servicio
PATCH /api/v1/services/{serviceId} — Actualizar un servicio
GET /api/v1/internal-services — Listar servicios internos
POST /api/v1/internal-services — Crear un servicio interno
PATCH /api/v1/internal-services/{internalServiceId} — Actualizar un servicio interno
GET /api/v1/planner/services — Listar los servicios por cubrir
POST /api/v1/planner/assignments — Asignar un recurso a un servicio
POST /api/v1/planner/assignments/remove — Quitar un recurso de un servicio
GET /api/v1/schedule — Obtener la agenda de un rango
GET /api/v1/availability/unavailabilities — Listar las indisponibilidades de un recurso
POST /api/v1/availability/unavailabilities — Declarar una indisponibilidad
PATCH /api/v1/availability/unavailabilities/{unavailabilityId} — Corregir o cerrar una indisponibilidad
GET /api/v1/incidents — Listar incidencias
POST /api/v1/incidents — Abrir una incidencia
PATCH /api/v1/incidents/{incidentId} — Actualizar una incidencia
GET /api/v1/incidents/status-counts — Contar incidencias por estado
POST /api/v1/incidents/{incidentId}/comments — Comentar una incidencia
GET /api/v1/notes — Listar las notas de una entidad
POST /api/v1/notes — Escribe una nota en una entidad
GET /api/v1/tasks — Listar tareas
POST /api/v1/tasks — Crear una tarea
PATCH /api/v1/tasks/{taskId} — Actualizar una tarea
GET /api/v1/task-types — Listar tipos de tarea
GET /api/v1/crm/opportunities — Listar oportunidades
POST /api/v1/crm/opportunities — Crear una oportunidad
PATCH /api/v1/crm/opportunities/{opportunityId} — Actualizar una oportunidad
PATCH /api/v1/crm/opportunities/{opportunityId}/stage — Mover una oportunidad a otra etapa
POST /api/v1/crm/opportunities/{opportunityId}/close — Cerrar una oportunidad
POST /api/v1/crm/opportunities/{opportunityId}/links — Vincular un documento a una oportunidad
GET /api/v1/crm/pipelines — Listar embudos
POST /api/v1/purchase-orders/{purchaseOrderId}/receive — Recibir material de un pedido de compra
GET /api/v1/supplier-invoices — Listar facturas de proveedor
GET /api/v1/treasury/accounts — Listar cuentas de tesorería
GET /api/v1/treasury/payments — Listar pagos de tesorería
POST /api/v1/treasury/payments — Registrar un pago entrante o saliente
PATCH /api/v1/treasury/payments/{paymentId} — Actualizar un pago
POST /api/v1/treasury/payments/{paymentId}/links — Vincular un pago a un documento
PUT /api/v1/orders/{orderId}/archive — Archivar o restaurar un pedido
PUT /api/v1/items/{itemId}/accessories — Actualizar los accesorios de un artículo
PUT /api/v1/items/{itemId}/alternatives — Actualizar las alternativas de un artículo
PATCH /api/v1/items/{itemId}/variants/{variantId} — Actualizar una variante de un artículo
GET /api/v1/planner/resources — Listar los recursos asignables
GET /api/v1/credit-notes — Listar notas de crédito
GET /api/v1/proformas — Listar proformas
POST /api/v1/contacts/lookup — Buscar contactos por referencia externa
POST /api/v1/orders/line-items/returns — Devolver líneas de pedido
POST /api/v1/ai/ask — Preguntar a la IA sobre tus datos
GET /api/v1/workflows — Listar workflows
POST /api/v1/workflows/{workflowId}/runs — Ejecutar un workflow
POST /api/v1/invoices/{invoiceId}/void — Anular una factura
PUT /api/v1/invoices/external/{originSystem}/{originExternalId} — Crear o actualizar el espejo de una factura emitida externamente
POST /api/v1/credit-notes/{creditNoteId}/void — Anular una nota de crédito
PATCH /api/v1/proformas/{proformaId}/status — Cambiar el estado comercial de una proforma
PATCH /api/v1/quotes/{quoteId}/status — Cambiar el estado comercial de un presupuesto
POST /api/v1/contracts/{contractId}/sign — Registrar la firma de un contrato
POST /api/v1/contracts/{contractId}/void — Anular un contrato
POST /api/v1/contracts/{contractId}/cancel — Cancelar un contrato a efectos operativos
POST /api/v1/supplier-invoices/{supplierInvoiceId}/void — Anular una factura de proveedor
GET /api/v1/payment-methods — Listar métodos de pago
GET /api/v1/users — Listar usuarios

Por MCP

Una llamada a una herramienta que falla vuelve con `isError` y el problema como contenido estructurado, con el mismo `code`.

¿Te ha resultado útil esta página?

Ejemplo