---
title: "Send the OAuth-bound agent connection proof to the canonical hosted mailbox."
method: POST
path: "/v1/workspaces/{workspaceId}/onboarding/agent-state/agent-proof"
---

# Send the OAuth-bound agent connection proof to the canonical hosted mailbox.

`POST /v1/workspaces/{workspaceId}/onboarding/agent-state/agent-proof`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/onboarding/agent-state/agent-proof`
- Auth: HTTP bearer

## Response `200`

The same OAuth grant replayed or already completed the proof.

- object
  - `data` AgentEmailProof, required
    - `status` 'pending' | 'verified', required
    - `attempt_id` string, uuid, required
    - `oauth_grant_id` string, required
    - `oauth_client_id` string, nullable, required
    - `client_name` string, nullable, required
    - `mailbox_id` string, uuid, required
    - `mailbox_address` string, email, required
    - `expected_subject` string, required
    - `initiated_at` string, date-time, required
    - `command_id` string, uuid
    - `send_status` string
    - `dispatch_status` 'completed' | 'already-running' | 'already-settled'
    - `replayed` boolean
    - `message_id` string, uuid
    - `thread_id` string, uuid
    - `received_at` string, date-time

## Other responses

- `202`: The real agent proof message was accepted for delivery.

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)