Errors
parameter_invalid
One or more parameters are invalid.
| HTTP status | Type | Code |
|---|---|---|
| 422 | invalid_request_error | parameter_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-callPOST /api/v1/tickets/{ticket_id}/activities— Add a note to a ticketPOST /api/v1/leads/bulk— Act on many leadsPOST /api/v1/leads/{lead_id}/call-now— Call a lead nowPOST /api/v1/instant/call-now— Call a lead in a campaign nowPOST /api/v1/agents/— Create an agentPOST /api/v1/calls/— Place a callPOST /api/v1/campaigns/— Create an empty campaignPOST /api/v1/campaigns/create-with-leads— Create a campaign with its leadsPOST /api/v1/leads/— Create a leadPOST /api/v1/leads/{lead_id}/notes— Add a notePOST /api/v1/tickets/— Create a ticketPOST /api/v1/webhook-endpoints/— Create a webhook endpointDELETE /api/v1/agents/{agent_id}— Delete an agentDELETE /api/v1/campaigns/{campaign_id}— Delete a campaignDELETE /api/v1/leads/{lead_id}— Delete a leadDELETE /api/v1/leads/{lead_id}/notes/{note_id}— Delete a noteDELETE /api/v1/webhook-endpoints/{endpoint_id}— Delete a webhook endpointGET /api/v1/agents/{agent_id}— Get an agentGET /api/v1/calls/{call_id}— Get a callGET /api/v1/calls/daily-counts— Calls per dayGET /api/v1/calls/performance— Call performanceGET /api/v1/calls/{call_id}/recording— Download a call recordingGET /api/v1/calls/{call_id}/transcript— Get a call transcriptGET /api/v1/campaigns/{campaign_id}— Get a campaignGET /api/v1/campaigns/{campaign_id}/dial-status— Dialing statusGET /api/v1/leads/{lead_id}— Get a leadGET /api/v1/leads/{lead_id}/timeline— Lead timelineGET /api/v1/phone-numbers/{phone_id}— Get a phone numberGET /api/v1/sip-trunks/{trunk_id}— Get a SIP trunkGET /api/v1/tickets/{ticket_id}— Get a ticketGET /api/v1/tools/{tool_id}— Get a toolGET /api/v1/usage— Get usage and balanceGET /api/v1/webhook-deliveries/{delivery_id}— Get a webhook deliveryGET /api/v1/webhook-endpoints/{endpoint_id}— Get a webhook endpointGET /api/v1/whatsapp/messages/{message_id}— Get a WhatsApp messagePOST /api/v1/agents/import— Import an agent from another platformGET /api/v1/agents/— List agentsGET /api/v1/callbacks— List scheduled callbacksGET /api/v1/calls/— List callsGET /api/v1/campaigns/{campaign_id}/leads— List a campaign's leadsGET /api/v1/campaigns/— List campaignsGET /api/v1/leads/{lead_id}/notes— List a lead's notesGET /api/v1/leads/— List leadsGET /api/v1/tickets/{ticket_id}/activities— List ticket activitiesGET /api/v1/tickets/categories— List ticket categoriesGET /api/v1/tickets/— List ticketsGET /api/v1/voices/— List voicesGET /api/v1/webhook-deliveries/— List webhook deliveriesGET /api/v1/whatsapp/message-templates— List WhatsApp templatesPOST /api/v1/agents/{agent_id}/pause— Stop taking callsPOST /api/v1/campaigns/{campaign_id}/pause-dialing— Pause automatic dialingPOST /api/v1/leads/{lead_id}/notes/{note_id}/pin— Pin a notePOST /api/v1/agents/{agent_id}/publish— Publish the agent's draftPOST /api/v1/webhook-deliveries/{delivery_id}/redeliver— Redeliver an eventDELETE /api/v1/leads/dnc/{lead_id}— Remove a number from do-not-callPOST /api/v1/tickets/{ticket_id}/replies— Reply to the customerPOST /api/v1/campaigns/{campaign_id}/resume-dialing— Resume automatic dialingPOST /api/v1/webhook-endpoints/{endpoint_id}/rotate-secret— Rotate an endpoint's signing secretPOST /api/v1/webhook-endpoints/{endpoint_id}/test— Send a test eventPOST /api/v1/whatsapp/messages— Send a WhatsApp messagePUT /api/v1/agents/{agent_id}/post-call-webhook— Set an agent's post-call webhookPOST /api/v1/agents/{agent_id}/go-live— Start taking callsPOST /api/v1/campaigns/{campaign_id}/start— Start a campaignPOST /api/v1/campaigns/{campaign_id}/stop— Stop a campaignPOST /api/v1/agents/{agent_id}/test-call— Place a test callDELETE /api/v1/leads/{lead_id}/notes/{note_id}/pin— Unpin a notePATCH /api/v1/agents/{agent_id}— Update an agentPUT /api/v1/campaigns/{campaign_id}— Update a campaignPUT /api/v1/campaigns/{campaign_id}/leads— Add or remove leadsPUT /api/v1/leads/{lead_id}— Update a leadPATCH /api/v1/leads/{lead_id}/notes/{note_id}— Edit a notePATCH /api/v1/tickets/{ticket_id}— Update a ticketPATCH /api/v1/webhook-endpoints/{endpoint_id}— Update a webhook endpoint