Skip to Content
CallMitraDocs
Errors

invalid_api_key

The API key is invalid or has been revoked.

HTTP statusTypeCode
401authentication_errorinvalid_api_key

What it means

The API key was not recognised. Check that you copied the full key, that it has not been revoked, and that you are calling the right environment.

How to handle it

Check that the X-API-Key header carries a current key. Create a new key in the console (Settings → Developers) if this one was revoked or expired. Do not retry in a loop.

Example response

{
  "detail": "The API key is invalid or has been revoked.",
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "The API key is invalid or has been revoked.",
    "param": null,
    "docUrl": "https://docs.callmitra.ai/errors/invalid_api_key",
    "requestId": "req_3f9c2a7d1b8e4c6a9f0e2d4b6a8c0e1f"
  }
}

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

Returned by

  • GET /api/v1/agency/clients — List client workspaces
  • GET /api/v1/agents/ — List agents
  • POST /api/v1/agents/ — Create an agent
  • POST /api/v1/agents/import — Import an agent from another platform
  • DELETE /api/v1/agents/{agent_id} — Delete an agent
  • GET /api/v1/agents/{agent_id} — Get an agent
  • PATCH /api/v1/agents/{agent_id} — Update an agent
  • POST /api/v1/agents/{agent_id}/go-live — Start taking calls
  • POST /api/v1/agents/{agent_id}/pause — Stop taking calls
  • PUT /api/v1/agents/{agent_id}/post-call-webhook — Set an agent's post-call webhook
  • POST /api/v1/agents/{agent_id}/publish — Publish the agent's draft
  • POST /api/v1/agents/{agent_id}/test-call — Place a test call
  • GET /api/v1/callbacks — List scheduled callbacks
  • GET /api/v1/calls/ — List calls
  • POST /api/v1/calls/ — Place a call
  • GET /api/v1/calls/daily-counts — Calls per day
  • GET /api/v1/calls/performance — Call performance
  • GET /api/v1/calls/{call_id} — Get a call
  • 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/ — List campaigns
  • POST /api/v1/campaigns/ — Create an empty campaign
  • POST /api/v1/campaigns/create-with-leads — Create a campaign with its leads
  • DELETE /api/v1/campaigns/{campaign_id} — Delete a campaign
  • GET /api/v1/campaigns/{campaign_id} — Get a campaign
  • PUT /api/v1/campaigns/{campaign_id} — Update a campaign
  • GET /api/v1/campaigns/{campaign_id}/dial-status — Dialing status
  • GET /api/v1/campaigns/{campaign_id}/leads — List a campaign's leads
  • PUT /api/v1/campaigns/{campaign_id}/leads — Add or remove leads
  • POST /api/v1/campaigns/{campaign_id}/pause-dialing — Pause automatic dialing
  • POST /api/v1/campaigns/{campaign_id}/resume-dialing — Resume automatic dialing
  • POST /api/v1/campaigns/{campaign_id}/start — Start a campaign
  • POST /api/v1/campaigns/{campaign_id}/stop — Stop a campaign
  • POST /api/v1/instant/call-now — Call a lead in a campaign now
  • GET /api/v1/lead-fields/catalog — List custom lead fields
  • GET /api/v1/leads/ — List leads
  • POST /api/v1/leads/ — Create a lead
  • POST /api/v1/leads/bulk — Act on many leads
  • GET /api/v1/leads/dnc — List do-not-call numbers
  • POST /api/v1/leads/dnc — Add numbers to do-not-call
  • DELETE /api/v1/leads/dnc/{lead_id} — Remove a number from do-not-call
  • DELETE /api/v1/leads/{lead_id} — Delete a lead
  • GET /api/v1/leads/{lead_id} — Get a lead
  • PUT /api/v1/leads/{lead_id} — Update a lead
  • POST /api/v1/leads/{lead_id}/call-now — Call a lead now
  • GET /api/v1/leads/{lead_id}/notes — List a lead's notes
  • POST /api/v1/leads/{lead_id}/notes — Add a note
  • DELETE /api/v1/leads/{lead_id}/notes/{note_id} — Delete a note
  • PATCH /api/v1/leads/{lead_id}/notes/{note_id} — Edit a note
  • DELETE /api/v1/leads/{lead_id}/notes/{note_id}/pin — Unpin a note
  • POST /api/v1/leads/{lead_id}/notes/{note_id}/pin — Pin a note
  • GET /api/v1/leads/{lead_id}/timeline — Lead timeline
  • GET /api/v1/phone-numbers/ — List phone numbers
  • GET /api/v1/phone-numbers/{phone_id} — Get a phone number
  • GET /api/v1/sip-trunks — List SIP trunks
  • GET /api/v1/sip-trunks/{trunk_id} — Get a SIP trunk
  • GET /api/v1/tickets/ — List tickets
  • POST /api/v1/tickets/ — Create a ticket
  • GET /api/v1/tickets/categories — List ticket categories
  • GET /api/v1/tickets/teams — List ticket teams
  • GET /api/v1/tickets/{ticket_id} — Get a ticket
  • PATCH /api/v1/tickets/{ticket_id} — Update a ticket
  • GET /api/v1/tickets/{ticket_id}/activities — List ticket activities
  • POST /api/v1/tickets/{ticket_id}/activities — Add a note to a ticket
  • POST /api/v1/tickets/{ticket_id}/replies — Reply to the customer
  • GET /api/v1/tools/ — List tools
  • GET /api/v1/tools/{tool_id} — Get a tool
  • GET /api/v1/usage — Get usage and balance
  • GET /api/v1/voices/ — List voices
  • GET /api/v1/webhook-deliveries/ — List webhook deliveries
  • GET /api/v1/webhook-deliveries/{delivery_id} — Get a webhook delivery
  • POST /api/v1/webhook-deliveries/{delivery_id}/redeliver — Redeliver an event
  • GET /api/v1/webhook-endpoints/ — List webhook endpoints
  • POST /api/v1/webhook-endpoints/ — Create a webhook endpoint
  • DELETE /api/v1/webhook-endpoints/{endpoint_id} — Delete a webhook endpoint
  • GET /api/v1/webhook-endpoints/{endpoint_id} — Get a webhook endpoint
  • PATCH /api/v1/webhook-endpoints/{endpoint_id} — Update a webhook endpoint
  • 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
  • GET /api/v1/webhook-event-types/ — List event types
  • GET /api/v1/whatsapp/message-templates — List WhatsApp templates
  • POST /api/v1/whatsapp/messages — Send a WhatsApp message
  • GET /api/v1/whatsapp/messages/{message_id} — Get a WhatsApp message
  • GET /api/v1/workspace — Check an API key

On this page