Proof Holdings

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'name', 'channel'], 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Display name of the challenger'}, 'channel': {'enum': ['telegram', 'whatsapp'], 'type': 'string', 'description': 'Messenger channel the challenger uses'}, 'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL config ID to enroll the challenger on'}, 'whatsapp_phone': {'type': 'string', 'description': 'E.164 phone with country code (required for the whatsapp channel)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID to add the member to'}, 'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Display name of the member'}, 'whatsapp_phone': {'type': 'string', 'pattern': '^\\+[1-9]\\d{7,14}$', 'description': 'E.164 WhatsApp phone with a leading + (optional, declared)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'member_id', 'channel', 'identifier'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}, 'channel': {'enum': ['telegram', 'whatsapp'], 'type': 'string', 'description': 'Channel type (telegram or whatsapp)'}, 'member_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Member ID to add the channel to'}, 'identifier': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Telegram chat id, or E.164 WhatsApp phone with a leading +'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Domain name to add (e.g. example.com)'}, 'for_email_sending': {'type': 'boolean', 'description': 'Whether this domain is for email sending'}, 'verification_method': {'enum': ['auto_dns', 'manual_dns', 'http_file', 'email'], 'type': 'string', 'description': 'Preferred verification method'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'provider', 'credentials'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'provider': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'DNS provider identifier'}, 'credentials': {'type': 'object', 'description': 'Provider-specific credential key-value pairs', 'additionalProperties': {'type': 'string', 'maxLength': 2000}}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID to cancel'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID to check credentials for'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain verification ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Domain verification session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['username'], 'properties': {'username': {'type': 'string', 'pattern': '^[a-zA-Z0-9_]+$', 'maxLength': 30, 'minLength': 3, 'description': 'Username to claim (3-30 chars, alphanumeric and underscores)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'code'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'code': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': 'Verification code from the email'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'api_token'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'api_token': {'type': 'string', 'minLength': 1, 'description': 'Cloudflare API token with DNS edit permissions'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'provider', 'credentials'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'provider': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'DNS provider identifier'}, 'credentials': {'type': 'object', 'description': 'Provider-specific credential key-value pairs', 'additionalProperties': {'type': 'string', 'maxLength': 2000}}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'api_key', 'api_secret'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'api_key': {'type': 'string', 'minLength': 1, 'description': 'GoDaddy API key'}, 'api_secret': {'type': 'string', 'minLength': 1, 'description': 'GoDaddy API secret'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel'], 'properties': {'email': {'type': 'string', 'format': 'email', 'description': 'Email address. Required for email channel.'}, 'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Authentication channel the user will verify through'}, 'phone_number': {'type': 'string', 'description': 'E.164 phone number. Required for SMS channel (determines DID routing).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Human-readable key name'}, 'scopes': {'type': 'array', 'items': {'enum': ['verifications:read', 'verifications:write', 'verifications:create', 'verifications:*', 'proofs:read', 'proofs:*', 'delegations:read', 'delegations:write', 'delegations:create', 'delegations:*', 'lookalike-watch:read', 'lookalike-watch:write', 'lookalike-watch:*', 'templates:read', 'templates:write', 'templates:*', 'authorizations:read', 'authorizations:write', 'authorizations:create', 'authorizations:*', 'hitl:read', 'hitl:write', 'hitl:create', 'hitl:*', 'confirmations:read', 'confirmations:write', 'confirmations:create', 'confirmations:*', 'circles:read', 'circles:write', 'circles:create', 'circles:*', 'profiles:read', 'profiles:write', 'profiles:*', 'billing:read', 'billing:write', 'billing:*', 'settings:read', 'settings:write', 'settings:*', 'assets:read', 'assets:write', 'assets:*', 'webhooks:read', 'webhooks:write', 'webhooks:*', 'auth:read', 'auth:write', 'auth:*'], 'type': 'string'}, 'maxItems': 20, 'description': 'Permission scopes for the key'}, 'profile_id': {'type': 'string', 'description': 'Bind the new key to a sub-account (PublicProfile) project you own (24-hex id). Immutable after creation; omit for an unbound account-wide key.'}, 'environment': {'enum': ['production', 'test'], 'type': 'string', 'description': 'Key environment (default: production)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'recipient', 'phone', 'channel', 'business_name'], 'properties': {'bsuid': {'type': 'string', 'pattern': '^[A-Z]{2}\\.[a-zA-Z0-9]{10,140}$', 'description': 'WhatsApp Business-Scoped User ID (alternative to phone for WhatsApp channel)'}, 'phone': {'type': 'string', 'pattern': '^\\+[1-9]\\d{1,14}$', 'description': 'Target phone number in E.164 format (e.g., +15551234567)'}, 'scope': {'enum': ['confirmations'], 'type': 'string', 'description': 'Authorization scope (default: confirmations)'}, 'channel': {'enum': ['whatsapp', 'telegram', 'sms', 'email'], 'type': 'string', 'description': 'Channel for sending confirmations'}, 'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL configuration ID to link this authorization to'}, 'recipient': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Channel-specific recipient identifier (chat_id for Telegram, phone/BSUID for WhatsApp)'}, 'expires_in': {'type': 'integer', 'maximum': 7776000, 'description': 'Expiry in seconds (max 90 days, default 90 days)', 'exclusiveMinimum': 0}, 'business_name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Business name displayed to user during authorization'}, 'business_profile_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Public profile ID for branding'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Human-readable name for the Circle'}, 'members': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Display name of the member'}, 'whatsapp_phone': {'type': 'string', 'pattern': '^\\+[1-9]\\d{7,14}$', 'description': 'E.164 WhatsApp phone with a leading + (declared)'}, 'telegram_chat_id': {'type': 'string', 'maxLength': 50, 'description': 'Telegram chat id (declared; usually captured at enrollment instead)'}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Initial members (name + optional declared channels)'}, 'profile_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Public profile (sub-account) to bind for branded messages â\x80\x94 create-only'}, 'proof_me_enabled': {'type': 'boolean', 'description': 'Enable Proof-Me drills for this Circle'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'member_id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}, 'member_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Member ID to drill'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'message'], 'properties': {'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL config ID whose channels will receive the approval request'}, 'message': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'The client-encrypted ciphertext envelope as a JSON string (v1 or v2) â\x80\x94 NOT the human-readable text. Encrypt the sentence the approver should read; passing it directly is refused with 400 `message_not_encrypted`, because the approval page can only decrypt an envelope.'}, 'proof_expiry_days': {'type': 'integer', 'description': 'Per-request proof expiry override in days (7, 30, 90, or 365)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['control_proof', 'delegate', 'scope'], 'properties': {'scope': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 32, 'minItems': 1, 'description': '1-32 capability scopes: lowercase kebab-case tokens, at most 64 characters each (e.g. send-email). NOT API scopes â\x80\x94 an API-style resource:action such as payments:read is rejected with invalid_scope.'}, 'delegate': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'enum': ['url', 'purl'], 'type': 'string', 'description': 'Identifier type: https URL or package URL (purl)'}, 'value': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'The artifact identifier (canonicalized server-side)'}}, 'description': 'The typed artifact being authorized', 'additionalProperties': False}, 'expires_in': {'type': 'integer', 'maximum': 315360000, 'description': "Lifetime in seconds (must not exceed the control proof's remainder)", 'exclusiveMinimum': 0}, 'control_proof': {'type': 'string', 'pattern': '^ph_ctl_[a-f0-9]{32}$', 'description': 'Public handle (ph_ctl_<32 hex>) of YOUR active domain control proof'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'credentials'], 'properties': {'provider': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'DNS provider identifier (e.g. cloudflare, route53, digitalocean)'}, 'credentials': {'type': 'object', 'description': 'Provider-specific credential key-value pairs', 'additionalProperties': {'type': 'string', 'maxLength': 2000}}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'channels'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Human-readable name for this HITL config'}, 'channels': {'type': 'array', 'items': {'anyOf': [{'type': 'object', 'required': ['type', 'config'], 'properties': {'type': {'type': 'string', 'const': 'telegram'}, 'config': {'type': 'object', 'required': ['chat_id'], 'properties': {'chat_id': {'type': 'string', 'maxLength': 50, 'minLength': 1}}, 'additionalProperties': False}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'config'], 'properties': {'type': {'type': 'string', 'const': 'whatsapp'}, 'config': {'type': 'object', 'properties': {'bsuid': {'type': 'string', 'pattern': '^[A-Z]{2}\\.[a-zA-Z0-9]{10,140}$', 'description': 'WhatsApp Business-Scoped User ID (e.g. US.abc123...)'}, 'phone_number': {'type': 'string', 'pattern': '^\\+?[1-9]\\d{6,14}$', 'description': 'Phone number in E.164 format'}}, 'additionalProperties': False}}, 'additionalProperties': False}]}, 'minItems': 1, 'description': 'Messaging channels for approval requests (telegram or whatsapp)'}, 'timeout_seconds': {'type': 'integer', 'maximum': 86400, 'minimum': 60, 'description': 'Default timeout in seconds (60â\x80\x9386400, default: 3600)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'challenger_id'], 'properties': {'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL config that holds the challenger'}, 'challenger_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Enrolled challenger initiating the check'}, 'suspicious_channel': {'enum': ['telegram', 'whatsapp'], 'type': 'string', 'description': 'Channel the suspicious contact reached the challenger on; defaults to the challenger channel'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['type', 'identifier', 'channels'], 'properties': {'type': {'enum': ['phone'], 'type': 'string', 'description': 'Asset type â\x80\x94 only "phone" is supported'}, 'channels': {'type': 'array', 'items': {'enum': ['whatsapp', 'telegram', 'sms'], 'type': 'string'}, 'maxItems': 4, 'minItems': 1, 'description': '1-4 unique channels attempted in parallel (first to complete wins)'}, 'identifier': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Phone number in E.164 format'}, 'client_metadata': {'type': 'object', 'description': 'Custom key-value metadata', 'additionalProperties': {'type': 'string'}}, 'external_user_id': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Your application user ID for grouping verifications'}, 'proof_expiry_days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Per-request proof expiry override in days (1-365)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'bio': {'type': 'string', 'maxLength': 500, 'description': 'Profile bio'}, 'theme': {'type': 'object', 'properties': {'font_style': {'enum': ['default', 'modern', 'classic'], 'type': 'string', 'description': 'Font style'}, 'gradient_end': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Gradient end color'}, 'primary_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Primary color (hex)'}, 'gradient_start': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Gradient start color'}, 'background_type': {'enum': ['solid', 'gradient'], 'type': 'string', 'description': 'Background type'}, 'background_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Background color (hex)'}}, 'description': 'Profile theme settings', 'additionalProperties': False}, 'is_public': {'type': 'boolean', 'description': 'Whether the profile is publicly visible'}, 'avatar_url': {'type': 'string', 'maxLength': 100000, 'description': 'Avatar as base64 data URI or URL (~75KB limit)'}, 'is_primary': {'type': 'boolean', 'description': 'Set as primary profile'}, 'is_business': {'type': 'boolean', 'description': 'Whether this is a business profile'}, 'display_name': {'type': 'string', 'maxLength': 100, 'description': 'Display name'}, 'business_name': {'type': 'string', 'maxLength': 100, 'description': 'Business name'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel', 'phone_number'], 'properties': {'channel': {'enum': ['sms', 'whatsapp', 'telegram'], 'type': 'string', 'description': 'Verification channel'}, 'metadata': {'type': 'object', 'description': 'Custom key-value metadata', 'additionalProperties': {'type': 'string'}}, 'template_id': {'type': 'string', 'description': 'Custom template ID'}, 'callback_url': {'type': 'string', 'description': 'URL to redirect after verification'}, 'phone_number': {'type': 'string', 'description': 'Phone number in E.164 format'}, 'external_user_id': {'type': 'string', 'description': 'Your application user ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['assets'], 'properties': {'assets': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 1, 'description': 'Asset type identifiers to request (e.g. email, phone, identity)'}, 'partial_ok': {'type': 'boolean', 'description': 'Whether partial asset sharing is acceptable (default: false)'}, 'action_type': {'enum': ['verification', 'onboarding', 'compliance'], 'type': 'string', 'description': 'Purpose of the request (default: verification)'}, 'callback_url': {'type': 'string', 'format': 'uri', 'description': 'Webhook URL for request status updates'}, 'redirect_url': {'type': 'string', 'format': 'uri', 'description': 'URL to redirect the subject after completing the request'}, 'reference_id': {'type': 'string', 'description': 'External reference ID for tracking'}, 'action_context': {'type': 'string', 'description': 'Additional context about why assets are needed'}, 'expires_in_hours': {'type': 'integer', 'maximum': 720, 'minimum': 1, 'description': 'Hours until request expires (default: 24)'}, 'public_profile_id': {'type': 'string', 'description': 'Public profile ID for branding'}, 'validity_requirement': {'type': 'string', 'description': 'Required validity level for shared assets'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['type', 'channel', 'identifier'], 'properties': {'type': {'enum': ['phone', 'email', 'domain', 'social', 'wallet', 'account', 'telegram_bot'], 'type': 'string', 'description': 'Asset type being verified'}, 'channel': {'enum': ['whatsapp', 'telegram', 'sms', 'email', 'dns', 'http', 'auto', 'github', 'google', 'facebook', 'x', 'linkedin', 'instagram', 'youtube', 'tiktok', 'ethereum', 'solana', 'bitcoin', 'coinbase', 'kraken', 'telegram_bot_token'], 'type': 'string', 'description': 'Verification channel (must match the asset type, e.g. sms/whatsapp/telegram for phone)'}, 'bot_token': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Telegram bot token (required for channel "telegram_bot_token")'}, 'identifier': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'The asset identifier to verify (E.164 phone, email address, domain, handle, wallet address, ...)'}, 'dns_provider': {'type': 'object', 'description': 'DNS provider credentials (required for channel "auto")', 'additionalProperties': {'type': 'string', 'maxLength': 2000}}, 'email_prefix': {'enum': ['admin', 'administrator', 'webmaster', 'hostmaster', 'postmaster'], 'type': 'string', 'description': 'Mailbox prefix for domain email verification'}, 'client_metadata': {'type': 'object', 'description': 'Custom key-value metadata', 'additionalProperties': {'type': 'string'}}, 'external_user_id': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Your application user ID for grouping verifications'}, 'proof_expiry_days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Per-request proof expiry override in days (1-365)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['assets'], 'properties': {'assets': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'enum': ['phone', 'email', 'domain', 'social', 'wallet', 'account', 'telegram_bot'], 'type': 'string', 'description': 'Asset type to verify'}, 'channel': {'enum': ['whatsapp', 'telegram', 'sms', 'email', 'dns', 'http', 'auto', 'github', 'google', 'facebook', 'x', 'linkedin', 'instagram', 'youtube', 'tiktok', 'ethereum', 'solana', 'bitcoin', 'coinbase', 'kraken', 'telegram_bot_token'], 'type': 'string', 'description': 'Preferred verification channel'}, 'required': {'type': 'boolean', 'description': 'Whether this asset must be verified for the request to complete (default: true)'}, 'identifier': {'type': 'string', 'description': 'The identifier to verify (phone number, email, domain, etc.). If omitted, the user provides their own.'}, 'allowed_channels': {'type': 'array', 'items': {'$ref': '#/properties/assets/items/properties/channel'}, 'description': 'Restrict to specific channels for this asset'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'Array of assets to verify (1-10)'}, 'expires_in': {'type': 'integer', 'description': 'Request expiry in seconds (default: 86400, max: 604800)', 'exclusiveMinimum': 0}, 'partial_ok': {'type': 'boolean', 'description': 'Allow partial completion (default: false)'}, 'action_type': {'enum': ['verification', '2fa', 'login', 'custom', 'confirmation'], 'type': 'string', 'description': 'Purpose of the verification (default: verification)'}, 'callback_url': {'type': 'string', 'description': 'Webhook URL for status updates (HTTPS only)'}, 'redirect_url': {'type': 'string', 'description': 'URL to redirect user after verification completes (HTTPS only)'}, 'reference_id': {'type': 'string', 'description': 'Your unique reference ID for this request'}, 'action_context': {'type': 'object', 'properties': {'title': {'type': 'string', 'description': 'Action title shown to user (required for custom/confirmation)'}, 'description': {'type': 'string', 'description': 'Action description shown to user'}}, 'description': 'Context displayed to user during verification', 'additionalProperties': False}, 'proof_expiry_days': {'type': 'integer', 'description': 'Per-request proof expiry override in days (7, 30, 90, or 365)'}, 'public_profile_id': {'type': 'string', 'description': 'Public profile ID for branding'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID to archive'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'DNS credential ID to delete'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID to delete'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'HITL config ID to delete'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id'], 'properties': {'hitl_id': {'type': 'string', 'description': 'HITL config ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id'], 'properties': {'profile_id': {'type': 'string', 'description': 'Profile ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id', 'channel', 'type'], 'properties': {'type': {'type': 'string', 'description': 'Message type (e.g. verification_request, login_request)'}, 'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'profile_id': {'type': 'string', 'description': 'Profile ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel', 'message_type'], 'properties': {'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'message_type': {'type': 'string', 'description': 'Message type (e.g. verification_request, login_request)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'End date filter (ISO 8601)'}, 'from': {'type': 'string', 'description': 'Start date filter (ISO 8601)'}, 'format': {'enum': ['csv', 'json'], 'type': 'string', 'description': 'Export format (default: json)'}, 'status': {'enum': ['pending', 'active', 'expired', 'revoked', 'denied'], 'type': 'string', 'description': 'Filter by status'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID to extend'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': '2FA session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Add-email session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Add-phone session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The API key id to fetch usage for'}, 'environment': {'enum': ['production', 'test'], 'type': 'string', 'description': 'Scope metrics to test or production data (default: production)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Asset ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Authorization ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Confirmation ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Confirmation ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^([0-9a-fA-F]{24}|ph_dlg_[a-f0-9]{32})$', 'description': 'Delegation ID (24-hex Mongo id or ph_dlg_<32 hex> handle)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'HITL config ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id'], 'properties': {'hitl_id': {'type': 'string', 'description': 'HITL config ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Identity challenge ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['group_id'], 'properties': {'group_id': {'type': 'string', 'description': 'Multi-channel verification group ID (format vg_<hex>)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'environment': {'enum': ['production', 'test'], 'type': 'string', 'description': 'Scope request/channel/HITL metrics to test or production data (default: production)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id'], 'properties': {'profile_id': {'type': 'string', 'description': 'Profile ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Public proof handle (ph_ctl_* / ph_dlg_*) or verification ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reference_id'], 'properties': {'reference_id': {'type': 'string', 'description': 'Your unique reference ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel', 'message_type'], 'properties': {'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'message_type': {'type': 'string', 'description': 'Message type (e.g. verification_request, login_request)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'months': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'Number of months of history'}, 'period': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}$', 'description': 'Month to query in YYYY-MM format (e.g. 2026-01)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Domain verification session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['external_user_id'], 'properties': {'external_user_id': {'type': 'string', 'description': 'The external user ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Webhook delivery ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'challenger_id'], 'properties': {'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL config ID'}, 'challenger_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Challenger ID to invite'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'member_id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}, 'member_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Member ID to invite'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'type': {'enum': ['phone', 'email', 'domain', 'social', 'wallet'], 'type': 'string', 'description': 'Filter by asset type'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'status': {'enum': ['active', 'revoked', 'expired'], 'type': 'string', 'description': 'Filter by status'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'phone': {'type': 'string', 'description': 'Filter by phone number'}, 'status': {'enum': ['pending', 'active', 'expired', 'revoked', 'denied'], 'type': 'string', 'description': 'Filter by authorization status'}, 'channel': {'enum': ['whatsapp', 'telegram', 'sms', 'email'], 'type': 'string', 'description': 'Filter by channel'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id'], 'properties': {'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL config ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'member_id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}, 'member_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Member ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 10000, 'description': 'Page number (default 1)', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'description': 'Items per page (default 20, max 100)', 'exclusiveMinimum': 0}, 'status': {'enum': ['active', 'archived'], 'type': 'string', 'description': 'Filter by status (archived excluded unless requested)'}, 'profile_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Filter by bound public profile (sub-account)'}, 'environment': {'enum': ['production', 'test'], 'type': 'string', 'description': 'Filter by environment (production or test)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'status': {'enum': ['pending', 'approved', 'denied'], 'type': 'string', 'description': 'Filter by confirmation status'}, 'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Filter by HITL config ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'status': {'enum': ['active', 'revoked'], 'type': 'string', 'description': "Filter by the delegation's OWN stored status (active|revoked). Does NOT filter the derived effective_status â\x80\x94 status=active still returns delegations whose control proof died, and ones that simply ran out."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'status': {'enum': ['active', 'archived'], 'type': 'string', 'description': 'Filter by status (active or archived)'}, 'environment': {'enum': ['production', 'test'], 'type': 'string', 'description': 'Filter by environment (production or test)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id'], 'properties': {'profile_id': {'type': 'string', 'description': 'Profile ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'status': {'enum': ['pending', 'partial', 'completed', 'expired', 'cancelled', 'active'], 'type': 'string', 'description': "Filter by status. 'active' = live (not-yet-expired) pending or partial requests; persisted statuses are time-aware."}, 'reference_id': {'type': 'string', 'description': 'Filter by reference ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'status': {'enum': ['pending', 'verified', 'failed', 'expired', 'revoked'], 'type': 'string', 'description': 'Filter by status'}, 'channel': {'enum': ['sms', 'whatsapp', 'telegram', 'email'], 'type': 'string', 'description': 'Filter by channel'}, 'external_user_id': {'type': 'string', 'description': 'Filter by external user ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'description': 'Page number', 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page'}, 'status': {'enum': ['pending', 'success', 'failed'], 'type': 'string', 'description': 'Filter by delivery status'}, 'event_type': {'type': 'string', 'description': 'Filter by event type (e.g. verification.completed)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'description': 'Discovery token from create_chat_id_discovery'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id', 'channel', 'message_type', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'Template body text'}, 'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'subject': {'type': 'string', 'maxLength': 200, 'description': 'Email subject line'}, 'profile_id': {'type': 'string', 'description': 'Profile ID'}, 'button_text': {'type': 'string', 'maxLength': 50, 'description': 'Button text'}, 'message_type': {'enum': ['verification_request', 'verification_success', 'verification_expired', 'login_request', 'login_success', '2fa_request', '2fa_success'], 'type': 'string', 'description': 'Message type'}, 'button_url_template': {'type': 'string', 'maxLength': 500, 'description': 'Button URL template'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel', 'message_type', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'Template body text'}, 'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'subject': {'type': 'string', 'maxLength': 200, 'description': 'Email subject line'}, 'button_text': {'type': 'string', 'maxLength': 50, 'description': 'Button text'}, 'message_type': {'enum': ['verification_request', 'verification_success', 'verification_expired', 'login_request', 'login_success', '2fa_request', '2fa_success'], 'type': 'string', 'description': 'Message type'}, 'button_url_template': {'type': 'string', 'maxLength': 500, 'description': 'Button URL template'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'API key ID to regenerate'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'challenger_id'], 'properties': {'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL config ID'}, 'challenger_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Challenger ID to remove'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'member_id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}, 'member_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Member ID to remove'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'member_id', 'channel_id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}, 'member_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Member ID'}, 'channel_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Channel ID to remove'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Email record ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Phone record ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The link to render â\x80\x94 e.g. a deep_link response field. Never a qr_text value: that is the link already rendered as QR art.'}, 'label': {'type': 'string', 'maxLength': 200, 'description': 'Optional label to display above the link (e.g. "Verify your phone number")'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel', 'message_type'], 'properties': {'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'variables': {'type': 'object', 'properties': {'code': {'type': 'string', 'description': 'Verification or login code'}, 'expires_in': {'type': 'string', 'description': 'Expiry duration text (e.g. "10 minutes")'}, 'callback_url': {'type': 'string', 'description': 'Callback URL for the action'}, 'user_identifier': {'type': 'string', 'description': 'User identifier (phone, email, or domain)'}}, 'description': 'Variables to substitute into the template', 'additionalProperties': False}, 'message_type': {'type': 'string', 'description': 'Message type'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'HITL config ID to request authorization for'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'email_prefix': {'enum': ['admin', 'administrator', 'webmaster', 'hostmaster', 'postmaster'], 'type': 'string', 'description': 'Email prefix to resend verification to'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Add-email session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Webhook delivery ID to retry'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'API key ID to revoke'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Asset ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Authorization ID to revoke'}, 'reason': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Reason for revocation'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Session ID to revoke'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^([0-9a-fA-F]{24}|ph_dlg_[a-f0-9]{32})$', 'description': 'Delegation ID (24-hex Mongo id or ph_dlg_<32 hex> handle)'}, 'reason': {'enum': ['user_request', 'fraud', 'key_compromise', 'other'], 'type': 'string', 'description': 'Reason for revocation'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Public proof handle (ph_ctl_* / ph_dlg_*) or verification ID'}, 'reason': {'type': 'string', 'description': 'Reason for revocation'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'maxLength': 100, 'minLength': 3, 'description': 'Prefix-anchored search query (minimum 3 characters)'}, 'type': {'enum': ['verification_requests', 'verifications', 'hitl', 'confirmations', 'authorizations', 'api_keys'], 'type': 'string', 'description': 'Narrow the search to a single result bucket'}, 'limit': {'type': 'integer', 'maximum': 25, 'description': 'Max results per bucket (default 10, max 25)', 'exclusiveMinimum': 0}, 'environment': {'enum': ['production', 'test'], 'type': 'string', 'description': 'Scope results to test or production data (default: production)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Account session id from create_account'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Email record ID to set as primary'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Phone record ID to set as primary'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id'], 'properties': {'profile_id': {'type': 'string', 'description': 'Profile ID to set as primary'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'from_email': {'type': 'string', 'format': 'email', 'description': 'Custom from email address for the domain'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action_type', 'channel'], 'properties': {'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Channel to receive the verification code'}, 'email_id': {'type': 'string', 'description': 'Specific email ID for email channel (optional)'}, 'action_type': {'enum': ['api_key_view', 'api_key_create', 'api_key_revoke', 'api_key_regenerate', 'phone_add', 'phone_remove', 'email_add', 'email_remove', 'account_delete'], 'type': 'string', 'description': 'The sensitive action requiring 2FA'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action_type', 'channel'], 'properties': {'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': "Channel for the 2FA challenge â\x80\x94 must differ from the user's last login channel"}, 'email_id': {'type': 'string', 'description': 'Optional: specific UserEmail id for email-channel 2FA'}, 'phone_id': {'type': 'string', 'description': 'Optional: specific UserPhone id for phone-channel 2FA'}, 'single_use': {'type': 'boolean', 'description': 'Whether the grant is consumed on first use. Server forces true for destructive action types. Defaults to true.'}, 'action_type': {'enum': ['api_key_create', 'api_key_revoke', 'api_key_regenerate', 'api_key_view', 'phone_remove', 'email_remove', 'account_delete', 'revocation_bulk', 'settings_write', 'profile_update', 'templates_write'], 'type': 'string', 'description': 'The sensitive action the 2FA grant will authorize. Destructive scopes (api_key_*, account_delete, phone_remove, email_remove, revocation_bulk) are capped at 5 min TTL + forced single-use. Configuration scopes (settings_write, profile_update, templates_write) allow up to 24h TTL with caller-chosen single_use. See config/twoFAPolicy.ts on the backend for the canonical policy.'}, 'ttl_seconds': {'type': 'integer', 'maximum': 86400, 'minimum': 60, 'description': 'Requested grant lifetime in seconds. Server caps to 300s for destructive action types, 86400s for configuration scopes. Defaults to 300 if omitted.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email'], 'properties': {'email': {'type': 'string', 'format': 'email', 'description': 'Email address to add'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel'], 'properties': {'channel': {'enum': ['telegram', 'whatsapp', 'sms'], 'type': 'string', 'description': 'Channel for phone verification'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID'}, 'email_prefix': {'enum': ['admin', 'administrator', 'webmaster', 'hostmaster', 'postmaster'], 'type': 'string', 'description': 'Email prefix to send verification to (default: admin)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Domain to verify (e.g. example.com)'}, 'customer_id': {'type': 'string', 'description': 'Customer identifier for B2B tracking'}, 'verification_method': {'enum': ['manual_dns', 'http_file'], 'type': 'string', 'description': 'Verification method (default: manual_dns)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel'], 'properties': {'email': {'type': 'string', 'format': 'email', 'description': 'Email address (required for email channel)'}, 'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Authentication channel'}, 'phone_number': {'type': 'string', 'description': 'Phone number in E.164 format (required for SMS channel)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Domain name to verify (e.g. example.com)'}, 'channel': {'enum': ['dns', 'http'], 'type': 'string', 'description': 'Verification channel (default: dns)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'code'], 'properties': {'id': {'type': 'string', 'description': 'Verification ID'}, 'code': {'type': 'string', 'description': 'The OTP or challenge code to submit'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'challenger_id'], 'properties': {'hitl_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'HITL config ID'}, 'challenger_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Challenger ID to drill'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{24}$', 'description': 'Circle ID'}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New name for the Circle'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'HITL config ID'}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'New name (null to clear)'}, 'channels': {'type': 'array', 'items': {'anyOf': [{'type': 'object', 'required': ['type', 'config'], 'properties': {'type': {'type': 'string', 'const': 'telegram'}, 'config': {'type': 'object', 'required': ['chat_id'], 'properties': {'chat_id': {'type': 'string', 'maxLength': 50, 'minLength': 1}}, 'additionalProperties': False}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'config'], 'properties': {'type': {'type': 'string', 'const': 'whatsapp'}, 'config': {'type': 'object', 'properties': {'bsuid': {'type': 'string', 'pattern': '^[A-Z]{2}\\.[a-zA-Z0-9]{10,140}$', 'description': 'WhatsApp Business-Scoped User ID (e.g. US.abc123...)'}, 'phone_number': {'type': 'string', 'pattern': '^\\+?[1-9]\\d{6,14}$', 'description': 'Phone number in E.164 format'}}, 'additionalProperties': False}}, 'additionalProperties': False}]}, 'minItems': 1, 'description': 'Updated channels'}, 'timeout_seconds': {'type': 'integer', 'maximum': 86400, 'minimum': 60, 'description': 'Updated timeout in seconds (60â\x80\x9386400)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'bio': {'type': 'string', 'maxLength': 500, 'description': 'Profile bio'}, 'theme': {'type': 'object', 'properties': {'font_style': {'enum': ['default', 'modern', 'classic'], 'type': 'string', 'description': 'Font style'}, 'gradient_end': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Gradient end color'}, 'primary_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Primary color (hex)'}, 'gradient_start': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Gradient start color'}, 'background_type': {'enum': ['solid', 'gradient'], 'type': 'string', 'description': 'Background type'}, 'background_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Background color (hex)'}}, 'description': 'Profile theme settings', 'additionalProperties': False}, 'is_public': {'type': 'boolean', 'description': 'Whether the profile is publicly visible'}, 'avatar_url': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'string', 'maxLength': 500000}]}, {'type': 'null'}], 'description': 'Avatar (HTTPS URL or base64 data URI, null to remove)'}, 'custom_links': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 500, 'description': 'Link URL'}, 'icon': {'type': 'string', 'maxLength': 50, 'description': 'Icon identifier'}, 'title': {'type': 'string', 'maxLength': 100, 'description': 'Link title'}, 'is_visible': {'type': 'boolean', 'description': 'Whether the link is visible'}, 'display_order': {'type': 'integer', 'minimum': 0, 'description': 'Display order'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Custom links (max 20)'}, 'display_name': {'type': 'string', 'maxLength': 100, 'description': 'Display name'}, 'show_proof_channels': {'type': 'boolean', 'description': 'Show proof channels'}, 'show_verification_dates': {'type': 'boolean', 'description': 'Show verification dates'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id'], 'properties': {'bio': {'type': 'string', 'maxLength': 500, 'description': 'Profile bio'}, 'theme': {'type': 'object', 'properties': {'font_style': {'enum': ['default', 'modern', 'classic'], 'type': 'string', 'description': 'Font style'}, 'gradient_end': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Gradient end color'}, 'primary_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Primary color (hex)'}, 'gradient_start': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Gradient start color'}, 'background_type': {'enum': ['solid', 'gradient'], 'type': 'string', 'description': 'Background type'}, 'background_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Background color (hex)'}}, 'description': 'Profile theme settings', 'additionalProperties': False}, 'is_public': {'type': 'boolean', 'description': 'Whether the profile is publicly visible'}, 'avatar_url': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'string', 'maxLength': 100000}]}, {'type': 'null'}], 'description': 'Avatar (base64 or URL, null to remove)'}, 'is_primary': {'type': 'boolean', 'description': 'Set as primary profile'}, 'profile_id': {'type': 'string', 'description': 'Profile ID'}, 'is_business': {'type': 'boolean', 'description': 'Whether this is a business profile'}, 'custom_links': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 500, 'description': 'Link URL'}, 'icon': {'type': 'string', 'maxLength': 50, 'description': 'Icon identifier'}, 'title': {'type': 'string', 'maxLength': 100, 'description': 'Link title'}, 'is_visible': {'type': 'boolean', 'description': 'Whether the link is visible'}, 'display_order': {'type': 'integer', 'minimum': 0, 'description': 'Display order'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Custom links (max 20)'}, 'display_name': {'type': 'string', 'maxLength': 100, 'description': 'Display name'}, 'business_name': {'type': 'string', 'maxLength': 100, 'description': 'Business name'}, 'show_proof_channels': {'type': 'boolean', 'description': 'Show proof channels on public profile'}, 'show_verification_dates': {'type': 'boolean', 'description': 'Show verification dates on public profile'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id', 'proofs'], 'properties': {'proofs': {'type': 'array', 'items': {'type': 'object', 'required': ['asset_id'], 'properties': {'label': {'type': 'string', 'maxLength': 50, 'description': 'Custom label (e.g. "Support Phone")'}, 'asset_id': {'type': 'string', 'description': 'Asset ID to display'}, 'is_visible': {'type': 'boolean', 'description': 'Whether this proof is visible'}, 'mask_level': {'enum': ['full', 'partial', 'hidden'], 'type': 'string', 'description': 'Privacy masking level'}, 'display_order': {'type': 'integer', 'minimum': 0, 'description': 'Display order'}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Proofs to display on profile'}, 'profile_id': {'type': 'string', 'description': 'Profile ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['profile_id', 'channel', 'type', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'Template body text with variable placeholders'}, 'type': {'type': 'string', 'description': 'Message type (e.g. verification_request, login_request)'}, 'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'subject': {'type': 'string', 'maxLength': 200, 'description': 'Email subject line (email channel only)'}, 'is_active': {'type': 'boolean', 'description': 'Whether the template is active'}, 'profile_id': {'type': 'string', 'description': 'Profile ID'}, 'button_text': {'type': 'string', 'maxLength': 50, 'description': 'Button text (email channel only)'}, 'button_url_template': {'type': 'string', 'maxLength': 500, 'description': 'Button URL template with placeholders'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proofs'], 'properties': {'proofs': {'type': 'array', 'items': {'type': 'object', 'required': ['asset_id'], 'properties': {'label': {'type': 'string', 'maxLength': 50, 'description': 'Custom label for the proof'}, 'asset_id': {'type': 'string', 'description': 'Asset ID to display'}, 'is_visible': {'type': 'boolean', 'description': 'Whether the proof is visible on the public profile'}, 'mask_level': {'enum': ['full', 'partial', 'hidden'], 'type': 'string', 'description': 'How much of the proof value to show'}, 'display_order': {'type': 'integer', 'minimum': 0, 'description': 'Display position (0-based)'}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Array of proof display configurations (max 50)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'webhook': {'type': 'object', 'properties': {'url': {'anyOf': [{'type': 'string', 'format': 'uri', 'maxLength': 2000}, {'type': 'null'}], 'description': 'HTTPS endpoint outbound webhooks are delivered to, at most 2000 characters; null removes it. Private, loopback and link-local addresses are refused.'}, 'events': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 32, 'description': 'Subscription patterns: an exact event type, a family wildcard such as "proof.*", or "*". An empty list means every event.'}, 'rotate_secret': {'type': 'boolean', 'description': 'Replace the signing secret and return the new value. The previous value stops verifying immediately.'}}, 'description': 'Outbound webhook configuration. Deliveries carry an HMAC-SHA256 X-Proof-Signature over "<X-Proof-Timestamp>.<body>".', 'additionalProperties': False}, 'branding': {'type': 'object', 'properties': {'logo_url': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'string', 'format': 'uri'}]}, {'type': 'null'}], 'description': 'HTTPS URL to business logo'}, 'email_theme': {'enum': ['dark', 'light'], 'type': 'string', 'description': 'Email template theme'}, 'business_name': {'type': 'string', 'maxLength': 100, 'description': 'Business name displayed in verifications'}, 'primary_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': 'Primary brand color (hex, e.g. #FF5733)'}, 'support_email': {'type': 'string', 'format': 'email', 'description': 'Support email shown in verification messages'}}, 'description': 'Branding settings to update', 'additionalProperties': False}, 'proof_expiry_days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Default proof-token lifetime in days for newly issued proofs'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel', 'message_type', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'Template body text with variable placeholders'}, 'channel': {'enum': ['telegram', 'whatsapp', 'sms', 'email'], 'type': 'string', 'description': 'Message channel'}, 'subject': {'type': 'string', 'maxLength': 200, 'description': 'Email subject line (email channel only)'}, 'button_text': {'type': 'string', 'maxLength': 50, 'description': 'Button text (email channel only)'}, 'message_type': {'type': 'string', 'description': 'Message type (e.g. verification_request, login_request)'}, 'button_url_template': {'type': 'string', 'maxLength': 500, 'description': 'Button URL template with placeholders'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hitl_id', 'public_key', 'encrypted_private_key', 'kdf_salt'], 'properties': {'hitl_id': {'type': 'string', 'description': 'HITL config ID'}, 'kdf_salt': {'type': 'string', 'description': 'Base64url-encoded PBKDF2 salt'}, 'public_key': {'type': 'string', 'description': 'PEM-encoded RSA-4096 SPKI public key'}, 'encrypted_private_key': {'type': 'string', 'description': 'JSON-serialized encrypted private key envelope (PBKDF2-SHA256+AES-256-GCM)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proof_token'], 'properties': {'identifier': {'type': 'string', 'description': 'Optional: the identifier this proof should be about (phone, email, domain, ...). When supplied, a proof about anything else answers valid:false with reason "identifier_mismatch"; a proof of an encrypted decision answers "identifier_unverifiable".'}, 'proof_token': {'type': 'string', 'description': 'The JWT proof token to validate'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id', 'code'], 'properties': {'code': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': 'Verification code'}, 'session_id': {'type': 'string', 'description': '2FA session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'description': 'Magic link token from the verification email'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['delegate', 'expected_principal'], 'properties': {'card': {'type': 'object', 'description': 'The MCP server card or A2A agent card to read the delegation from', 'additionalProperties': {}}, 'token': {'type': 'string', 'description': 'A raw delegation token, when you already have it instead of a card'}, 'delegate': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'enum': ['url', 'purl'], 'type': 'string', 'description': 'Identifier type: https URL or package URL (purl)'}, 'value': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'The artifact identifier YOU resolved â\x80\x94 never a value read from inside the artifact you are checking, and resolved afresh rather than carried over from earlier in the conversation'}}, 'description': 'The artifact identity you resolved independently. Required: this comparison is what defeats a copied token.', 'additionalProperties': False}, 'check_status': {'type': 'boolean', 'description': 'Default true. When false the signature and claims are checked but revocation is NOT â\x80\x94 treat the result as "not revoked-checked", never as "not revoked".'}, 'required_scopes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 32, 'minItems': 1, 'description': 'Capability scopes the delegation must grant'}, 'expected_principal': {'type': 'string', 'maxLength': 253, 'minLength': 1, 'description': 'Required. The domain you expect to have authorized this artifact (e.g. postmarkapp.com) â\x80\x94 an issuer binds the artifact to nothing, so any domain owner can mint a valid delegation for someone else\'s package. Without this pin the answer is only "some domain claims this".'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['delegate', 'expected_principal'], 'properties': {'card': {'type': 'object', 'description': 'The MCP server card or A2A agent card to read the delegation from', 'additionalProperties': {}}, 'token': {'type': 'string', 'description': 'A raw delegation token, when you already have it instead of a card'}, 'delegate': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'enum': ['url', 'purl'], 'type': 'string', 'description': 'Identifier type: https URL or package URL (purl)'}, 'value': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'The artifact identifier YOU resolved â\x80\x94 never a value read from inside the artifact you are checking, and resolved afresh rather than carried over from earlier in the conversation'}}, 'description': 'The artifact identity you resolved independently. Required: this comparison is what defeats a copied token.', 'additionalProperties': False}, 'required_scopes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 32, 'minItems': 1, 'description': 'Capability scopes the delegation must grant'}, 'expected_principal': {'type': 'string', 'maxLength': 253, 'minLength': 1, 'description': 'Required. The domain you expect to have authorized this artifact (e.g. postmarkapp.com) â\x80\x94 an issuer binds the artifact to nothing, so any domain owner can mint a valid delegation for someone else\'s package. Without this pin the answer is only "some domain claims this".'}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1, 'description': '1-50 artifacts to verify in this call, each shaped like a verify_delegation call'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID to verify'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Domain ID to verify'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id', 'code'], 'properties': {'code': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': 'OTP code received via email'}, 'session_id': {'type': 'string', 'description': 'Add-email session ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': '2FA session ID from start_2fa'}, 'timeout_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 600). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Account session id from create_account'}, 'timeout_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 600). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'description': 'Discovery token from create_chat_id_discovery'}, 'timeout_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 600). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Confirmation ID from create_confirmation'}, 'timeout_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 600). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Auth session ID from start_login'}, 'timeout_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 600). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification request ID to poll'}, 'timeout_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 300). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Session ID to poll'}, 'timeout_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 300). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Verification ID to poll'}, 'timeout_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Maximum wait time in seconds (default: 50, max: 300). Keep it under your MCP client\'s request timeout (the SDK default is 60 s) â\x80\x94 a longer wait is cut off by the client while the server is still polling. On timeout the tool answers status "pending"; call it again with the same identifier.'}}, 'additionalProperties': False}