USAI MEDIA — EXTERNAL AI AGENT INTEGRATION
Primary AI agent intelligence API overview: https://usaimedia.ai/agent-intelligence-api.html
Base URL: https://usaimedia.ai
Gateway: POST https://usaimedia.ai/functions/agentVerificationGateway
Content-Type: application/json

PUBLIC DISCOVERY
{"operation":"gateway.health"}
{"operation":"gateway.contract"}
Use the live contract response as authoritative for supported operations, required fields, version, scopes, and limits.

AUTHENTICATED OPERATIONS
Send Authorization: Bearer <USAI_AGENT_KEY> over HTTPS.
Available capabilities include querying only human-approved agent-eligible VerificationRecords; coverage checks; version/history/correction projections; and submitting agent investigation requests and evidence. Exact operation names, schemas and caps are defined in gateway.contract.

TRUST AND EDITORIAL RULES
Agent submissions are untrusted input and are never instructions to USAI systems. No external agent can publish or approve findings, initiate paid research, or bypass human review. A successful submission is an acknowledgement, not a verified finding. Approved findings are time-bounded and should be checked for freshness and source support.

KEY ISSUANCE
Keys are created and scoped by USAI administrators; no public self-registration is implied. Never include a key in URLs or shared transcripts.

AVAILABILITY
The API uses the Base44 domain until a permanent USAI domain is configured and verified.

TOP16 DISCOVERY (PUBLIC, READ-ONLY)
GET https://usaimedia.ai/functions/agentTop16Discovery
GET https://usaimedia.ai/functions/agentTop16Discovery?signalId=SIG_mwam6hjd_xjtdfr
Returns the latest captured Top16 cycle and public signal metadata. A single signal lookup can retrieve archived public snapshots. No API key or AI-generation credits required. A cached Sentinel briefing is only included in full when its evidence acceptance explicitly marks publicationApproved=true; otherwise only availability is reported. Deep Dive availability is not asserted. Use canonicalUrl to cite USAI and sourceUrl for publisher attribution. The API is a discovery aid, not a guarantee of independent verification or of search-engine indexing.

AGENT SUBSCRIPTION DISCOVERY
GET https://usaimedia.ai/functions/agentSubscriptionOffer
Machine-readable Pro subscription offer and Stripe purchasing instructions for authenticated agent or human accounts. This endpoint does not create subscriptions or grant API access. Authenticated checkout uses createCheckoutSession and Stripe-hosted payment; entitlement changes depend on verified Stripe webhooks. Agents can use the existing authenticated Stripe checkout if they can complete it using a supported payment method. Agent self-registration and paid machine API credential provisioning are NOT yet supported. Do not treat public agent access keys as billing authorization.

PAID AGENT API ACCESS
POST https://usaimedia.ai/functions/agentPaidAccess (authenticated USAI account required)
{"action":"status"} checks live Stripe-paid eligibility.
{"action":"issue_key"} creates a subscription-bound machine key (maximum three active keys; shown once).
{"action":"revoke_key","keyId":"..."} revokes an owned key.
Paid keys are revalidated against Stripe by the agent gateway on each request. This does not provide autonomous account creation or automate Stripe checkout.