InfluTo for AI Agents

Discovery (4)

Pure lookups — which SDK, which validation path, which invariant.

• influto_list_sdks — The four SDKs with package id, registry, repo and current version.
• influto_recommend_sdk — Free-text stack ('expo', 'swiftui', 'kotlin', …) → the ONE SDK + peer deps.
• influto_recommend_validation — Pick the ONE validation path: RevenueCat webhook vs store-direct (never both).
• influto_explain_contract — Wire-contract invariants per topic: attribution, purchase, comp, dedup, rc-attributes.

Scaffold (6)

Version-correct code snippets straight from the SDK registry.

• influto_scaffold_install — Install command(s) + peer dependencies for an SDK.
• influto_scaffold_init — The one-time initialize() snippet (THROWS on failure — surface it).
• influto_scaffold_attribution — The checkAttribution() launch snippet.
• influto_scaffold_manual_code — Optional manual referral-code entry / ReferralCodeInput snippet.
• influto_scaffold_report_purchase — Store-direct purchase-reporting snippet (skip on the RevenueCat path).
• influto_scaffold_full — One call → the exact ordered integration steps for a stack + validation path.

Provision (7)

Stand up the account side: org → app (+ API key) → campaign.

• influto_whoami — The developer + organizations behind the connected agent.
• influto_create_org — Create an organization (only when whoami shows none).
• influto_search_store — Search the App Store + Google Play for an app's store identifiers.
• influto_scrape_store — Scrape store metadata incl. the numeric Apple app_store_id.
• influto_check_slug — Is an app slug free? (Slugs are globally unique — first segment of referral URLs.)
• influto_provision — Org → app (+ API key + webhook secret) → campaign → activate, in one idempotent call.
• influto_regenerate_webhook_secret — Rotate the RevenueCat webhook secret (returned once).

Configure (7)

Wire the purchase-validation path; secrets go through signed deep-links.

• influto_get_validation_status — Per-platform validation config + what's missing (non-secret).
• influto_setup_revenuecat — The webhook URL + the two subscriber attributes to wire RevenueCat.
• influto_get_credential_upload_link — Signed deep-link the HUMAN opens to upload credentials — secrets never transit the agent.
• influto_set_apple_meta — Non-secret Apple identifiers: Issuer ID, Key ID, environment, App Store ID.
• influto_validate_store_credentials — Run the live credential green-check (loop while retryable).
• influto_activate_store_direct — Flip a platform to store-direct once the green-check passed.
• influto_recommend_validation_for_platforms — Which path to wire and what it needs (configure-flow reminder).

Verify (4)

The differentiator: prove a real ATTRIBUTED conversion happened.

• influto_integration_status — THE verify rollup: {live, checklist[], attributed_conversion_count, campaign health, …}.
• influto_recent_events — Recent SDK events + purchase webhooks with attribution flags (SANDBOX/PRODUCTION filter).
• influto_test_integration — Fire a SANDBOX INITIAL_PURCHASE through the real attribution pipeline.
• influto_verify_user_conversions — Did a specific app_user_id's purchases attribute?

Operate (14)

Run the program: apps, campaigns (milestone bonuses + i18n), awards, analytics.

• influto_list_apps — Every app across the developer's orgs, with canonical click totals.
• influto_get_app — Full app detail incl. *_i18n maps, support_email and creator-code settings.
• influto_update_app — Update whitelisted app settings (i18n dicts merge; credentials excluded).
• influto_list_campaigns — Campaigns by app/status with canonical clicks + milestone counts.
• influto_get_campaign — Full campaign: commission, bonus_rules, i18n copy, stats.
• influto_create_campaign — Full-featured create incl. milestone bonus_rules + i18n (created as DRAFT).
• influto_update_campaign — Update a campaign — same surface as create.
• influto_set_campaign_status — Activate/pause; activation enforces wallet escrow (402 → top-up deep-link).
• influto_list_bonus_awards — Milestone awards with creator identity + live fraud-aware progress.
• influto_review_bonus_award — Approve or void an earned milestone award (pre-payout only).
• influto_get_analytics_overview — Per-app period rollup: canonical clicks (+ decomposition), installs, trials, conversions, revenue, commission.
• influto_get_campaign_funnel — Clicks → installs → trials → paid with step rates (find the leak).
• influto_list_top_affiliates — Top creators by period revenue for an app or campaign.
• influto_get_daily_performance — Zero-filled daily series for trend checks and charts.

Grow (15)

Recruit and reward creators; read-only wallet visibility; the doctor.

• influto_list_affiliates — Every creator in a campaign: codes, canonical clicks, earnings, milestone progress, INFLU- code state.
• influto_invite_creator — Invite one creator by email (localized invitation + personal message; optional custom commission).
• influto_invite_creators_batch — Bulk-invite from a list/CSV — live capacity accounting, per-item results, partial success.
• influto_withdraw_invitation — Withdraw a PENDING invite (frees a marketplace capacity slot).
• influto_get_join_link — The shareable public join-page URL (?lang=xx, OG card) + readiness warnings.
• influto_list_invitations — Invitation states across campaigns (default: still pending).
• influto_list_free_codes — Free-access codes incl. platform-issued INFLU- creator codes + redemption state.
• influto_create_free_code — Mint a comp/free-access code (ambassadors, press, VIPs) — no purchase needed.
• influto_list_assets — Marketing assets creators use for content (filter by type/category).
• influto_set_asset_featured — Curate which assets show as join-page content examples.
• influto_get_asset_upload_link — Signed deep-link the HUMAN opens to upload asset files.
• influto_get_wallet — READ-ONLY wallet snapshot: balance, reserved, safe_available, can_activate_campaigns, and invite_capacity (marketplace slots + daily email budget) — read before inviting.
• influto_get_wallet_topup_link — Signed deep-link to the billing page — the HUMAN completes the Stripe checkout.
• influto_localize_campaign — Localize campaign copy (server translator, or hands the copy back for the agent to translate + write back).
• influto_doctor — Auth mode, principal, scopes, orgs, per-app freshness — call FIRST when anything misbehaves.

Identity & provision

GET  /api/agent/whoami
GET  /api/agent/doctor
POST /api/agent/organizations
GET  /api/agent/store/search · GET /api/agent/store/scrape
GET  /api/agent/apps/check-slug/{slug}
POST /api/agent/provision
POST /api/agent/apps/{app_id}/regenerate-webhook-secret

Configure validation

GET  /api/agent/apps/{app_id}/validation-status
POST /api/agent/apps/{app_id}/credential-setup-link
PATCH /api/agent/apps/{app_id}/apple-meta
POST /api/agent/apps/{app_id}/validate-store-credentials
POST /api/agent/apps/{app_id}/activate-store-direct

Verify (the loop)

GET  /api/agent/apps/{app_id}/integration-status
GET  /api/agent/apps/{app_id}/events/recent
POST /api/agent/apps/{app_id}/test-integration
GET  /api/agent/apps/{app_id}/verify-user-conversions?app_user_id=…

Operate (apps · campaigns · bonuses · analytics)

GET  /api/agent/apps · GET/PATCH /api/agent/apps/{app_id}
GET  /api/agent/campaigns · GET/PATCH /api/agent/campaigns/{campaign_id}
POST /api/agent/apps/{app_id}/campaigns
POST /api/agent/campaigns/{campaign_id}/status
GET  /api/agent/bonus-awards · POST /api/agent/bonus-awards/{award_id}/review
GET  /api/agent/apps/{app_id}/analytics/overview
GET  /api/agent/campaigns/{campaign_id}/funnel
GET  /api/agent/analytics/top-affiliates
GET  /api/agent/campaigns/{campaign_id}/daily-performance

Grow (creators · codes · assets · wallet)

GET  /api/agent/campaigns/{campaign_id}/affiliates
POST /api/agent/campaigns/{campaign_id}/invite
GET  /api/agent/campaigns/{campaign_id}/join-link
GET  /api/agent/invitations
GET/POST /api/agent/apps/{app_id}/free-codes
GET  /api/agent/apps/{app_id}/assets · POST /api/agent/assets/{asset_id}/featured
POST /api/agent/apps/{app_id}/asset-upload-link
GET  /api/agent/wallet · POST /api/agent/wallet/topup-link
POST /api/agent/campaigns/{campaign_id}/localize