Popdot AI

{'type': 'object', 'required': ['trialHandle', 'answers'], 'properties': {'answers': {'type': 'array', 'items': {'type': 'object', 'required': ['question_id', 'response'], 'properties': {'response': {'type': 'string'}, 'question_id': {'type': 'string'}}}, 'description': 'Your answers to the safety questions, one { question_id, response } per question.'}, 'publicKey': {'type': 'string', 'description': 'Optional, on the call that goes live. Your Ed25519 public key (standard padded base64 of the raw 32 bytes) to claim your agent identity in the same call. Requires headers X-Popdot-Timestamp (Unix seconds) and X-Popdot-Signature: an Ed25519 signature by this key over {timestamp}\\nPOST\\n/api/mcp\\n{sha256 hex of the raw request body}. Omit it to receive a claim token for upgrade_trial instead.'}, 'trialHandle': {'type': 'string', 'description': 'The trialHandle returned by try_domain.'}}}

{'type': 'object', 'properties': {'url': {'type': 'string'}, 'sigil': {'type': 'object', 'required': ['sigilId', 'publicKey', 'mandateId'], 'properties': {'sigilId': {'type': 'string'}, 'agentName': {'type': 'string'}, 'mandateId': {'type': 'string'}, 'publicKey': {'type': 'string'}}}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'sigilId': {'type': 'string'}, 'trialId': {'type': 'string'}, 'upgrade': {'type': 'object', 'properties': {'preserveExactUrl': {'type': 'boolean'}, 'availableDurations': {'type': 'array', 'items': {'type': 'string'}}, 'agentPaymentAvailable': {'type': 'boolean'}}}, 'expiresAt': {'type': 'string'}, 'retryable': {'type': 'boolean'}, 'claimError': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}}}, 'claimToken': {'type': 'string'}, 'candidateId': {'type': 'string'}, 'shareMessage': {'type': 'string'}, 'trustReceipt': {'type': 'object', 'properties': {'claimable': {'type': 'boolean'}, 'canaryVerified': {'type': 'boolean'}}}, 'canaryVerdict': {'type': 'string'}, 'scorerVersion': {'type': 'string'}, 'claimTokenExpiresAt': {'type': 'string'}}}

{'type': 'object', 'required': ['domainId', 'subdomain'], 'properties': {'domainId': {'type': 'string', 'description': 'The parent domain: its id from search_domains, or its name (for example addedtocart.shop)'}, 'subdomain': {'type': 'string', 'description': "The subdomain label to check (e.g., 'myproject' for myproject.example.com)"}}}

{'type': 'object', 'required': ['domainId', 'subdomain', 'available'], 'properties': {'reason': {'type': 'string'}, 'fullUrl': {'type': 'string'}, 'domainId': {'type': 'string'}, 'available': {'type': 'boolean'}, 'subdomain': {'type': 'string'}, 'fullDomain': {'type': 'string'}}}

{'type': 'object', 'required': ['domainId', 'duration'], 'properties': {'domainId': {'type': 'string', 'description': 'The domain to price: its id from search_domains, or its name (for example addedtocart.shop)'}, 'duration': {'enum': ['PT1H', 'PT4H', 'P1D', 'P7D', 'P30D'], 'type': 'string', 'description': 'ISO 8601 duration: PT1H (1 hour), PT4H (4 hours), P1D (1 day), P7D (1 week), P30D (30 days)'}}}

{'type': 'object', 'required': ['domainId', 'totalCost', 'currency'], 'properties': {'tier': {'type': 'string'}, 'hours': {'type': 'number'}, 'feeNote': {'type': 'string'}, 'currency': {'type': 'string'}, 'domainId': {'type': 'string'}, 'duration': {'type': 'string'}, 'available': {'type': 'boolean'}, 'tierScore': {'type': 'number'}, 'totalCost': {'type': 'number'}, 'fullDomain': {'type': 'string'}, 'serviceFee': {'type': 'number'}, 'ownerPayout': {'type': 'number'}, 'priceSource': {'enum': ['owner', 'algorithm'], 'type': 'string'}, 'rentalPrice': {'type': 'number'}, 'durationLabel': {'type': 'string'}, 'priceBreakdown': {'type': 'object', 'properties': {'daily': {'type': 'number'}, 'hourly': {'type': 'number'}, 'weekly': {'type': 'number'}, 'monthly': {'type': 'number'}}}, 'ownerCommission': {'type': 'number'}, 'ownerCommissionPercent': {'type': 'number'}}}

{'type': 'object', 'required': ['intentMandateId', 'domainId', 'subdomain', 'duration'], 'properties': {'txHash': {'type': 'string', 'description': '(phase 2) The on-chain transaction hash of your USDC payment on Base.'}, 'domainId': {'type': 'string', 'description': 'The unique ID of the domain to rent on'}, 'duration': {'enum': ['PT1H', 'PT4H', 'P1D', 'P7D', 'P30D'], 'type': 'string', 'description': 'ISO 8601 duration: PT1H (1 hour), PT4H (4 hours), P1D (1 day), P7D (1 week), P30D (30 days)'}, 'paymentId': {'type': 'string', 'description': '(phase 2) The paymentId returned by the phase-1 challenge.'}, 'subdomain': {'type': 'string', 'description': "The subdomain label to rent (e.g., 'myproject' for myproject.example.com)"}, 'payerProof': {'type': 'string', 'description': '(phase 1) EIP-191 personal_sign signature proving control of payerAddress. Always required with payerAddress.'}, 'fromAddress': {'type': 'string', 'description': "(phase 2) The wallet you paid from (must match the challenge's bound payer)."}, 'payerAddress': {'type': 'string', 'description': '(phase 1) The 0x wallet you will pay from. Required on every challenge; a wallet registered on your Sigil does not substitute for it.'}, 'intentMandateId': {'type': 'string', 'description': 'The ID of the active Intent Mandate authorizing this purchase'}, 'payerProofIssuedAt': {'type': 'string', 'description': '(phase 1, optional) ISO 8601 timestamp of the payerProof, within 5 minutes of the request.'}}}

{'type': 'object', 'properties': {'next': {'type': 'string'}, 'reason': {'type': 'string'}, 'rental': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'status': {'type': 'string'}, 'endTime': {'type': 'string'}, 'fullUrl': {'type': 'string'}, 'startTime': {'type': 'string'}, 'subdomain': {'type': 'string'}}}, 'status': {'type': 'string'}, 'payment': {'type': 'object', 'properties': {'memo': {'type': 'string'}, 'status': {'type': 'string'}, 'txHash': {'type': 'string'}, 'chainId': {'type': 'number'}, 'protocol': {'type': 'string'}, 'expiresAt': {'type': 'string'}, 'paymentId': {'type': 'string'}, 'recipient': {'type': 'string'}, 'settleUrl': {'type': 'string'}, 'tokenAddress': {'type': 'string'}, 'amountInSmallestUnit': {'type': 'string'}}}, 'rentalId': {'type': 'string'}, 'settleUrl': {'type': 'string'}, 'credential': {'type': 'string'}, 'provisioning': {'type': 'object', 'properties': {'message': {'type': 'string'}, 'statusUrl': {'type': 'string'}, 'timeoutSeconds': {'type': 'number'}, 'pollIntervalSeconds': {'type': 'number'}}}, 'tierProgression': {'type': 'object', 'properties': {'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'currentTier': {'enum': ['nascent', 'fledgling', 'established', 'trusted', 'sovereign'], 'type': 'string'}, 'nextEvaluationAt': {'type': 'string'}, 'evidenceConfidence': {'type': 'number'}}, 'description': 'Current enforced trust tier and when it is next evaluated. Present only once an identity exists.'}, 'sigilEligibility': {'type': 'object', 'properties': {'status': {'enum': ['eligible', 'awaiting_key_binding', 'active', 'review_required', 'denied', 'suspended', 'revoked'], 'type': 'string'}, 'hardGates': {'type': 'array', 'items': {'type': 'string'}}, 'canaryStatus': {'type': 'string'}}, 'description': 'Identity standing: lifecycle status, canary screen result, and any hard gates.'}, 'identityConfidence': {'type': 'object', 'properties': {'level': {'enum': ['unbound', 'key_bound', 'sponsor_verified'], 'type': 'string'}, 'sponsorVerified': {'type': 'boolean'}}, 'description': 'How firmly this identity is bound: unbound, bound to a key, or backed by a verified sponsor.'}}}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'Maximum number of results to return (default: 20, max: 50)'}, 'query': {'type': 'string', 'description': 'Search query to match against domain names, tags, and categories'}, 'emotion': {'enum': ['comedy', 'absurd', 'playful', 'edgy', 'wholesome', 'professional', 'trustworthy'], 'type': 'string', 'description': 'Filter by the reaction the domain is built to elicit: comedy, absurd, playful, edgy, wholesome, professional, trustworthy. Unknown values are ignored.'}, 'maxPrice': {'type': 'number', 'description': 'Maximum daily price in USD'}, 'minPrice': {'type': 'number', 'description': 'Minimum daily price in USD'}}}

{'type': 'object', 'required': ['domains'], 'properties': {'domains': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'tld': {'type': 'string'}, 'name': {'type': 'string'}, 'tier': {'type': 'string'}, 'pricing': {'type': 'object', 'properties': {'daily': {'type': 'number'}, 'hourly': {'type': 'number'}, 'weekly': {'type': 'number'}, 'monthly': {'type': 'number'}, 'currency': {'type': 'string'}}}, 'tierScore': {'type': 'number'}, 'fullDomain': {'type': 'string'}, 'emotionTags': {'type': 'array', 'items': {'type': 'string'}}}}}, 'pagination': {'type': 'object', 'properties': {'page': {'type': 'number'}, 'limit': {'type': 'number'}, 'total': {'type': 'number'}, 'totalPages': {'type': 'number'}}}}}

{'type': 'object', 'required': ['goal'], 'properties': {'goal': {'type': 'string', 'description': 'What you built and want to put online, in a sentence (used to name and describe the address).'}, 'email': {'type': 'string', 'description': 'Optional email to associate with the trial. Never returned.'}, 'target': {'type': 'string', 'description': 'An https URL to point the address at. Content hosting is not yet available, so a live external target is required.'}, 'publicKey': {'type': 'string', 'description': 'Optional, on the call that goes live. Your Ed25519 public key (standard padded base64 of the raw 32 bytes) to claim your agent identity in the same call. Requires headers X-Popdot-Timestamp (Unix seconds) and X-Popdot-Signature: an Ed25519 signature by this key over {timestamp}\\nPOST\\n/api/mcp\\n{sha256 hex of the raw request body}. Omit it to receive a claim token for upgrade_trial instead.'}, 'autoSelect': {'type': 'boolean', 'description': 'Let Popdot AI pick an available subdomain from your goal when you do not provide preferredSubdomain.'}, 'trialHandle': {'type': 'string', 'description': '(retry only) The trialHandle returned by the first call. Echo it back with your answers.'}, 'desiredEmotion': {'enum': ['comedy', 'absurd', 'playful', 'edgy', 'wholesome', 'professional', 'trustworthy'], 'type': 'string', 'description': 'Preferred vibe of the parent domain: comedy, absurd, playful, edgy, wholesome, professional, trustworthy. Unknown values are ignored.'}, 'inputResponses': {'type': 'array', 'items': {'type': 'object'}, 'description': '(retry only) Your answers to the safety questions, one { id, response } per requested input.'}, 'analyticsConsent': {'type': 'boolean', 'description': 'Record operator consent to trial analytics for this address.'}, 'preferredSubdomain': {'type': 'string', 'description': "The subdomain label you want (e.g. 'mydemo'). Omit and set autoSelect:true to have one picked for you."}}}

{'type': 'object', 'properties': {'url': {'type': 'string'}, 'next': {'type': 'string'}, 'sigil': {'type': 'object', 'required': ['sigilId', 'publicKey', 'mandateId'], 'properties': {'sigilId': {'type': 'string'}, 'agentName': {'type': 'string'}, 'mandateId': {'type': 'string'}, 'publicKey': {'type': 'string'}}}, 'domain': {'type': 'string'}, 'sigilId': {'type': 'string'}, 'trialId': {'type': 'string'}, 'upgrade': {'type': 'object', 'properties': {'preserveExactUrl': {'type': 'boolean'}, 'availableDurations': {'type': 'array', 'items': {'type': 'string'}}, 'agentPaymentAvailable': {'type': 'boolean'}}}, 'expiresAt': {'type': 'string'}, 'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['question_id', 'prompt'], 'properties': {'prompt': {'type': 'string'}, 'question_id': {'type': 'string'}}}}, 'subdomain': {'type': 'string'}, 'claimError': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}}}, 'claimToken': {'type': 'string'}, 'candidateId': {'type': 'string'}, 'trialHandle': {'type': 'string'}, 'shareMessage': {'type': 'string'}, 'trustReceipt': {'type': 'object', 'properties': {'claimable': {'type': 'boolean'}, 'canaryVerified': {'type': 'boolean'}}}, 'canaryVerdict': {'type': 'string'}, 'scorerVersion': {'type': 'string'}, 'tierProgression': {'type': 'object', 'properties': {'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'currentTier': {'enum': ['nascent', 'fledgling', 'established', 'trusted', 'sovereign'], 'type': 'string'}, 'nextEvaluationAt': {'type': 'string'}, 'evidenceConfidence': {'type': 'number'}}, 'description': 'Current enforced trust tier and when it is next evaluated. Present only once an identity exists.'}, 'sigilEligibility': {'type': 'object', 'properties': {'status': {'enum': ['eligible', 'awaiting_key_binding', 'active', 'review_required', 'denied', 'suspended', 'revoked'], 'type': 'string'}, 'hardGates': {'type': 'array', 'items': {'type': 'string'}}, 'canaryStatus': {'type': 'string'}}, 'description': 'Identity standing: lifecycle status, canary screen result, and any hard gates.'}, 'identityConfidence': {'type': 'object', 'properties': {'level': {'enum': ['unbound', 'key_bound', 'sponsor_verified'], 'type': 'string'}, 'sponsorVerified': {'type': 'boolean'}}, 'description': 'How firmly this identity is bound: unbound, bound to a key, or backed by a verified sponsor.'}, 'claimTokenExpiresAt': {'type': 'string'}}}

{'type': 'object', 'required': ['claimToken', 'sigilId', 'publicKey', 'timestamp', 'signature'], 'properties': {'sigilId': {'type': 'string', 'description': 'The sigilId returned with the claim token. It must match the identity the token belongs to.'}, 'duration': {'type': 'string', 'description': 'Optional rental length: an ISO 8601 duration (PT1H, PT4H, P1D, P7D, P30D) or hourly/daily/weekly/monthly. Defaults to PT1H (1 hour).'}, 'publicKey': {'type': 'string', 'description': 'Your Ed25519 public key as standard padded base64 of the raw 32 bytes (44 characters). You keep the private key.'}, 'signature': {'type': 'string', 'description': 'Standard padded base64 of the 64-byte Ed25519 signature over the popdot-claim/1 message.'}, 'timestamp': {'type': 'string', 'description': 'Integer Unix seconds, no leading zeros, within 300 seconds of now. Part of the signed message.'}, 'claimToken': {'type': 'string', 'description': 'The one-time claim token returned by try_domain / answer_trial_canary.'}, 'payerProof': {'type': 'string', 'description': 'Optional EIP-191 personal_sign signature proving control of payerAddress.'}, 'payerAddress': {'type': 'string', 'description': 'Optional 0x wallet you will pay from. Provide it (with payerProof) to receive a self-pay x402 challenge.'}, 'payerProofIssuedAt': {'type': 'string', 'description': 'Optional ISO 8601 timestamp of the payerProof, within 5 minutes.'}}}

{'type': 'object', 'required': ['sigil', 'upgrade'], 'properties': {'sigil': {'type': 'object', 'required': ['sigilId', 'publicKey', 'mandateId'], 'properties': {'sigilId': {'type': 'string'}, 'agentName': {'type': 'string'}, 'mandateId': {'type': 'string'}, 'publicKey': {'type': 'string'}}}, 'upgrade': {'type': 'object', 'properties': {'fqdn': {'type': 'string'}, 'note': {'type': 'string'}, 'payment': {'type': 'object', 'properties': {'memo': {'type': 'string'}, 'status': {'type': 'string'}, 'txHash': {'type': 'string'}, 'chainId': {'type': 'number'}, 'protocol': {'type': 'string'}, 'expiresAt': {'type': 'string'}, 'paymentId': {'type': 'string'}, 'recipient': {'type': 'string'}, 'settleUrl': {'type': 'string'}, 'tokenAddress': {'type': 'string'}, 'amountInSmallestUnit': {'type': 'string'}}}, 'duration': {'type': 'string'}, 'preserveExactUrl': {'type': 'boolean'}}}, 'walletGuidance': {'type': 'string'}, 'tierProgression': {'type': 'object', 'properties': {'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'currentTier': {'enum': ['nascent', 'fledgling', 'established', 'trusted', 'sovereign'], 'type': 'string'}, 'nextEvaluationAt': {'type': 'string'}, 'evidenceConfidence': {'type': 'number'}}, 'description': 'Current enforced trust tier and when it is next evaluated. Present only once an identity exists.'}, 'sigilEligibility': {'type': 'object', 'properties': {'status': {'enum': ['eligible', 'awaiting_key_binding', 'active', 'review_required', 'denied', 'suspended', 'revoked'], 'type': 'string'}, 'hardGates': {'type': 'array', 'items': {'type': 'string'}}, 'canaryStatus': {'type': 'string'}}, 'description': 'Identity standing: lifecycle status, canary screen result, and any hard gates.'}, 'identityConfidence': {'type': 'object', 'properties': {'level': {'enum': ['unbound', 'key_bound', 'sponsor_verified'], 'type': 'string'}, 'sponsorVerified': {'type': 'boolean'}}, 'description': 'How firmly this identity is bound: unbound, bound to a key, or backed by a verified sponsor.'}}}