Skip to Content
CallMitraDocs
Errors

bad_request

The request could not be processed.

HTTP statusTypeCode
400invalid_request_errorbad_request

What it means

The request was malformed or asked for something the resource does not allow in its current state. Read the message, correct the request, and try again.

How to handle it

Fix the request before sending it again; retrying the same request returns the same error. error.param names the offending field when there is one.

Example response

{
  "detail": "The request could not be processed.",
  "error": {
    "type": "invalid_request_error",
    "code": "bad_request",
    "message": "The request could not be processed.",
    "param": null,
    "docUrl": "https://docs.callmitra.ai/errors/bad_request",
    "requestId": "req_3f9c2a7d1b8e4c6a9f0e2d4b6a8c0e1f"
  }
}

Branch on error.code; it never changes once published. The message text can change. See Errors for the envelope.

Returned by

  • POST /api/v1/leads/dnc — Add numbers to do-not-call
  • POST /api/v1/tickets/{ticket_id}/activities — Add a note to a ticket
  • POST /api/v1/leads/bulk — Act on many leads
  • POST /api/v1/leads/{lead_id}/call-now — Call a lead now
  • POST /api/v1/instant/call-now — Call a lead in a campaign now
  • POST /api/v1/agents/ — Create an agent
  • POST /api/v1/calls/ — Place a call
  • POST /api/v1/campaigns/ — Create an empty campaign
  • POST /api/v1/campaigns/create-with-leads — Create a campaign with its leads
  • POST /api/v1/leads/ — Create a lead
  • POST /api/v1/leads/{lead_id}/notes — Add a note
  • POST /api/v1/tickets/ — Create a ticket
  • POST /api/v1/webhook-endpoints/ — Create a webhook endpoint
  • POST /api/v1/agents/import — Import an agent from another platform
  • GET /api/v1/campaigns/ — List campaigns
  • GET /api/v1/leads/{lead_id}/notes — List a lead's notes
  • POST /api/v1/whatsapp/messages — Send a WhatsApp message
  • POST /api/v1/campaigns/{campaign_id}/start — Start a campaign
  • PUT /api/v1/campaigns/{campaign_id} — Update a campaign
  • PUT /api/v1/leads/{lead_id} — Update a lead

On this page