Errors

Every error is an RFC 9457 problem document (application/problem+json). Branch on code; type links to the code's page here.

{
  "type": "https://codriver.autouncle.com/developers/errors/lead_source_not_found",
  "title": "Lead source not found or inactive",
  "status": 404,
  "code": "lead_source_not_found",
  "success": false,
  "error": "Lead source not found or inactive"
}

errors lists field-level problems where there are several. success, error (the title) and message (the detail) are there for clients written before problem details.

Retry 429 after Retry-After, and 5xx with backoff. Never retry other 4xx unchanged: fix the request.

Error codes

• bad_request (400): The request couldn't be read, usually malformed JSON or a missing body.
• external_reference_in_progress (409): A push with this `external_reference` is still being accepted.
• idempotency_key_in_progress (409): A request with this Idempotency-Key is still being processed.
• idempotency_key_invalid (400): The Idempotency-Key header is empty or longer than 255 characters.
• idempotency_key_reused (422): This Idempotency-Key was already used for a different request in the last 24 hours.
• insufficient_scope (403): The access token lacks a scope this endpoint requires.
• invalid_cursor (400): The `cursor` or `after` value isn't one AutoUncle CoDriver gave you.
• invalid_image_urls (400): One or more trade-in image URLs aren't public HTTPS URLs.
• invalid_parameter (400): A query parameter is out of range or malformed (`limit`, a timestamp, an event type, an incomplete external reference).
• invalid_timestamp (400): The lead's `timestamp` isn't an ISO 8601 time.
• invalid_token (401): The access token is missing, invalid or expired.
• invalid_trade_in_field (400): A trade-in field has a value AutoUncle CoDriver doesn't accept.
• lead_not_eligible (422): This lead can't take trade-in updates.
• lead_not_found (404): No lead with this ID or correlation ID in your organization.
• lead_source_not_api (422): The lead source isn't an API lead source (it is for email or CSV).
• lead_source_not_found (404): No active lead source with this ID in your organization.
• missing_contact (400): The lead has neither an email nor a phone number.
• missing_correlation_id (400): The trade-in update has no `correlation_id`.
• missing_image_urls (400): The trade-in photo request has no image URLs.
• missing_lead_details (400): The lead has a contact method but nothing else.
• missing_lead_source (400): The lead has no `lead_source_id`.
• missing_trade_in_update (400): The trade-in update has neither image URLs nor a vehicle field.
• not_found (404): The record doesn't exist in your organization.
• opportunity_not_found (404): No opportunity with this ID in your organization.
• opportunity_not_ready (404): The lead hasn't become an opportunity yet.
• organization_not_approved (403): The dealer's organization is still waiting for approval.
• rate_limited (429): The API client used its requests for this minute.
• trade_in_vehicle_not_ready (404): The lead's trade-in vehicle doesn't exist yet.
• unauthorized (401): The token isn't tied to an organization.
• validation_failed (422): The request is well-formed but a value isn't acceptable.