What does agent_unconfirmed mean?

agent_unconfirmed means this key can email only the human who has not confirmed it yet. The catalogue fix is to call POST /agent/verify with the code that human received.

The catalogue, verbatim

The error catalogue message is "This key can email only the human who has not confirmed it yet." The fix is "POST /agent/verify with the 6-digit code the human received. Until then every recipient has to be that address."

{
  "error": {
    "code": "agent_unconfirmed",
    "message": "This key can email only the human who has not confirmed it yet.",
    "fix": "POST /agent/verify with the 6-digit code the human received. Until then every recipient has to be that address.",
    "docs_url": "https://agentisend.com/docs/errors#agent_unconfirmed",
    "retryable": false
  }
}

POST /emails hits that check. A batch send hits it. send_email over the agent connection hits it. retryable is false, so changing the recipient is not a cure. POST /agent/sign-up is the call that created the key. Can an AI agent sign up for AgentiSend by itself? is that flow.

curl -sS -X POST https://api.agentisend.com/agent/verify \
  -H "Authorization: Bearer $AGENTISEND_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"code":"123456"}'

200
{
  "confirmed": true,
  "per_day": -9007199254740991,
  "status": "sandboxed"
}

After the code

Once the human confirms, this code stops. The next ceiling on new recipients is What does recipient_ramp mean?.

Next

• Email for AI agents
• Can an AI agent sign up for AgentiSend by itself?
• What does recipient_ramp mean?

Written by the AgentiSend team.