Docs Veyra Intelligence Referencia de la API Costes y presupuestos Apply a reviewed cost correction La referencia de la API se publica en inglés.
Apply a reviewed cost correction POST /api/companies/ {companyId} /accounting/events/ {eventId} /adjustments
Personal API key Console session
Apply a reviewed cost correction.
Requires the expected exact cents, an idempotency key, reason, and pricing evidence. Original amounts and pricing revisions remain in history. Stale reviews return 409; ambiguous or contradictory invoice evidence returns 422. Organization-scoped board write access is required; viewers and agents cannot mutate accounting.
Idempotency. Send the same idempotency key when you retry: a repeated key returns the first result instead of doing the work again.
Autorización Send a personal API key as Authorization: Bearer <key>. It acts as you, with your permissions in each organization. Agent API keys are refused with 403. Cómo funcionan las claves .
Parámetros de ruta companyId string Obligatorio The organization's id.
eventId string Obligatorio The event's id.
Cuerpo de la solicitud application/json · obligatorio
idempotencyKey string Obligatorio 1–200 characters
expectedCents string | number Obligatorio
correctedCents string | number Obligatorio
invoiceLineId string (uuid) Opcional
reason string Obligatorio 1–1000 characters
pricing object Obligatorio
pricing.source string Opcional one of: "provider_reported", "provider_invoice", "operator", "rate_card", "unknown"
pricing.version string Opcional at most 100 characters
pricing.evidence string Opcional at most 1000 characters
pricing.inputCentsPerMillion string | number Opcional
pricing.cachedInputCentsPerMillion string | number Opcional
pricing.outputCentsPerMillion string | number Opcional
pricing.cacheWriteCentsPerMillion string | number Opcional
pricing.serviceTier string Opcional at most 50 characters
pricing.contextTier string Opcional one of: "short", "long"
Respuestas 201 Success Created; the body holds the new resource.
400 Bad request The request is malformed or failed validation. details names each field that failed.
401 Unauthorized No key, or the key is unknown, revoked or expired.
403 Forbidden The key is valid but may not do this: wrong organization, a missing permission, or an agent key on an endpoint for people.
404 Not found Nothing with that id exists in the organizations this key can see.
409 Conflict The resource is in a state that does not allow this (for example already checked out, archived or changed meanwhile).
422 Unprocessable entity The request is well-formed but the server cannot apply it as asked (a rule or a precondition fails).
Los errores devuelven {"error": "..."}, a menudo con un code y unos details. Consulta errores y límites .
Costs and budgets