Authentication

Exchange a sign-in code for an API key

Creates an AI agent connection for an account owner or administrator. Accounts with two-factor authentication must use browser sign-in.

post/v1/agent_auth/verify_code

Request

  • Base URL: https://api.revdoku.com
  • URL: https://api.revdoku.com/v1/agent_auth/verify_code
  • Auth: none required

Request body

emailstring email required
codestring required

Six digits; spaces are ignored.

labelstring

Connection name shown in Account access.

permission_scope'mailbox_read' | 'mailbox_write' | 'mailbox_admin'
mailbox_access'all' | 'selected'
mailbox_idsstring[]

Required when mailbox_access is selected.

mailbox_permissionsobject

Optional access per selected mailbox ID: read or write. Without an entry, a mailbox gets write, or read when permission_scope is mailbox_read.

account_idstring

Select another granted account for this request.

reasonstring nullable

Optional purpose for this action. AI agents should explain intentional reads and changes when known; omit when unknown. Do not include secrets, file contents, or transcripts.

Response

Created

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.