Skip to Content
CallMitraDocs
Errors

parameter_invalid

One or more parameters are invalid.

HTTP statusTypeCode
422invalid_request_errorparameter_invalid

What it means

A field is missing, has the wrong type, or has a value outside the allowed range. error.param names the first offending field and detail lists every problem.

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": [
    {
      "type": "missing",
      "loc": [
        "body",
        "phone"
      ],
      "msg": "Field required"
    }
  ],
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid",
    "message": "One or more parameters are invalid.",
    "param": "phone",
    "docUrl": "https://docs.callmitra.ai/errors/parameter_invalid",
    "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
  • DELETE /api/v1/agents/{agent_id} — Delete an agent
  • DELETE /api/v1/campaigns/{campaign_id} — Delete a campaign
  • DELETE /api/v1/leads/{lead_id} — Delete a lead
  • DELETE /api/v1/leads/{lead_id}/notes/{note_id} — Delete a note
  • DELETE /api/v1/webhook-endpoints/{endpoint_id} — Delete a webhook endpoint
  • GET /api/v1/agents/{agent_id} — Get an agent
  • GET /api/v1/calls/{call_id} — Get a call
  • GET /api/v1/calls/daily-counts — Calls per day
  • GET /api/v1/calls/performance — Call performance
  • GET /api/v1/calls/{call_id}/recording — Download a call recording
  • GET /api/v1/calls/{call_id}/transcript — Get a call transcript
  • GET /api/v1/campaigns/{campaign_id} — Get a campaign
  • GET /api/v1/campaigns/{campaign_id}/dial-status — Dialing status
  • GET /api/v1/leads/{lead_id} — Get a lead
  • GET /api/v1/leads/{lead_id}/timeline — Lead timeline
  • GET /api/v1/phone-numbers/{phone_id} — Get a phone number
  • GET /api/v1/sip-trunks/{trunk_id} — Get a SIP trunk
  • GET /api/v1/tickets/{ticket_id} — Get a ticket
  • GET /api/v1/tools/{tool_id} — Get a tool
  • GET /api/v1/usage — Get usage and balance
  • GET /api/v1/webhook-deliveries/{delivery_id} — Get a webhook delivery
  • GET /api/v1/webhook-endpoints/{endpoint_id} — Get a webhook endpoint
  • GET /api/v1/whatsapp/messages/{message_id} — Get a WhatsApp message
  • POST /api/v1/agents/import — Import an agent from another platform
  • GET /api/v1/agents/ — List agents
  • GET /api/v1/callbacks — List scheduled callbacks
  • GET /api/v1/calls/ — List calls
  • GET /api/v1/campaigns/{campaign_id}/leads — List a campaign's leads
  • GET /api/v1/campaigns/ — List campaigns
  • GET /api/v1/leads/{lead_id}/notes — List a lead's notes
  • GET /api/v1/leads/ — List leads
  • GET /api/v1/tickets/{ticket_id}/activities — List ticket activities
  • GET /api/v1/tickets/categories — List ticket categories
  • GET /api/v1/tickets/ — List tickets
  • GET /api/v1/voices/ — List voices
  • GET /api/v1/webhook-deliveries/ — List webhook deliveries
  • GET /api/v1/whatsapp/message-templates — List WhatsApp templates
  • POST /api/v1/agents/{agent_id}/pause — Stop taking calls
  • POST /api/v1/campaigns/{campaign_id}/pause-dialing — Pause automatic dialing
  • POST /api/v1/leads/{lead_id}/notes/{note_id}/pin — Pin a note
  • POST /api/v1/agents/{agent_id}/publish — Publish the agent's draft
  • POST /api/v1/webhook-deliveries/{delivery_id}/redeliver — Redeliver an event
  • DELETE /api/v1/leads/dnc/{lead_id} — Remove a number from do-not-call
  • POST /api/v1/tickets/{ticket_id}/replies — Reply to the customer
  • POST /api/v1/campaigns/{campaign_id}/resume-dialing — Resume automatic dialing
  • POST /api/v1/webhook-endpoints/{endpoint_id}/rotate-secret — Rotate an endpoint's signing secret
  • POST /api/v1/webhook-endpoints/{endpoint_id}/test — Send a test event
  • POST /api/v1/whatsapp/messages — Send a WhatsApp message
  • PUT /api/v1/agents/{agent_id}/post-call-webhook — Set an agent's post-call webhook
  • POST /api/v1/agents/{agent_id}/go-live — Start taking calls
  • POST /api/v1/campaigns/{campaign_id}/start — Start a campaign
  • POST /api/v1/campaigns/{campaign_id}/stop — Stop a campaign
  • POST /api/v1/agents/{agent_id}/test-call — Place a test call
  • DELETE /api/v1/leads/{lead_id}/notes/{note_id}/pin — Unpin a note
  • PATCH /api/v1/agents/{agent_id} — Update an agent
  • PUT /api/v1/campaigns/{campaign_id} — Update a campaign
  • PUT /api/v1/campaigns/{campaign_id}/leads — Add or remove leads
  • PUT /api/v1/leads/{lead_id} — Update a lead
  • PATCH /api/v1/leads/{lead_id}/notes/{note_id} — Edit a note
  • PATCH /api/v1/tickets/{ticket_id} — Update a ticket
  • PATCH /api/v1/webhook-endpoints/{endpoint_id} — Update a webhook endpoint

On this page