AGagentmail-to
inboxes

Authorize Inbox

Changed on

Authorizes the AgentID sign-in a client is already waiting in, for the inbox in the path, and returns the ID of the pending public key it will activate. Read the key with Get API Key. A repeat for the same token, inbox, and bearer returns the same key ID. A 403 AppSignupLimitError means the app accepts no more sign-ups from your organization.

post/v0/inboxes/{inbox_id}/authorize

Request

  • Base URL
    https://api.agentmail.to
  • URL
    https://api.agentmail.to/v0/inboxes/{inbox_id}/authorize
  • Auth
    HTTP bearer

Path parameters

inbox_idstring required

The ID of the inbox.

Request body

auth_tokenstring required

Token identifying one pending AgentID sign-in, read from the sign-in action on exactly https://auth.agentid.com.

accept_disclosureboolean

Accept the app's disclosure on the agent's behalf, skipping the first-use disclosure page. Requires app_share_owner when owner scopes are involved.

Response

Response with status 202

api_key_idstring required

ID of api key.

instructions'Authorization complete. Return to browser.' required

The agent's next step. Nothing further is required from the agent.

Changes