Developer

Public API surface map

Public and app-facing route-handler families used by Apex runtime, operations, automation, analytics, and integrations.

Public runtime

Browser-facing configuration, preview sessions, forced QA URLs, and harness artifacts used by the storefront runtime and QA surfaces.

  • /api/exp
  • /api/preview
  • /api/preview-sessions
  • /api/qa-preview
  • /api/harness/sessions/[token]/manifest
  • /api/harness/artifacts/[id]

Internal and admin-only route handlers are intentionally excluded from this public developer map.

Experiments and variants

Dashboard CRUD, lifecycle actions, launch checks, experiment-goal joins, conflict detection, and variation updates.

  • /api/experiments
  • /api/experiments/[id]
  • /api/experiments/[id]/start
  • /api/experiments/[id]/pause
  • /api/experiments/[id]/complete
  • /api/experiments/[id]/archive
  • /api/experiments/[id]/restore
  • /api/experiments/[id]/goals
  • /api/experiments/[id]/create-flag
  • /api/experiments/conflicts
  • /api/variations/[varId]

Operator, variant workbench, and QA

Model-led build loop, context reduction, network introspection, persisted runs, screenshot capture, evidence storage, QA packets, code workspace files, build output, and revision diffs.

  • /api/operator-chat-session
  • /api/operator-context-reduce
  • /api/operator-events
  • /api/operator-evidence
  • /api/operator-network
  • /api/operator-runs
  • /api/operator-screenshot
  • /api/operator-dev-bridge
  • /api/experiments/[id]/qa
  • /api/experiments/[id]/qa/run
  • /api/experiments/[id]/qa/goal-verification
  • /api/experiments/[id]/qa/screenshots
  • /api/experiments/[id]/variations/[variationId]/workspace
  • /api/experiments/[id]/variations/[variationId]/files
  • /api/experiments/[id]/variations/[variationId]/files/[...path]
  • /api/experiments/[id]/variations/[variationId]/build
  • /api/experiments/[id]/variations/[variationId]/revisions
  • /api/experiments/[id]/variations/[variationId]/revisions/[revisionId]/diff
  • /api/qa-audit
  • /api/tools/search-code

Foundations and learning

Metrics, audiences, signals, assets, store profile memory, audit evidence, findings, and learning runs.

  • /api/goals
  • /api/goals/[id]
  • /api/segments
  • /api/segments/[id]
  • /api/signals
  • /api/signals/[id]
  • /api/assets
  • /api/assets/[id]
  • /api/assets/[id]/usage
  • /api/store-profile
  • /api/store-profile/facts/[id]
  • /api/store-profile/findings/review
  • /api/store-profile/learning-runs
  • /api/shop-audits
  • /api/shop-audits/collect
  • /api/shop-audits/profile
  • /api/shop-audits/findings/[id]

Backlog and results

Idea intake, comments, archive/restore, experiment creation from ideas, handoff packets, and result import/readback.

  • /api/backlog
  • /api/backlog/[id]
  • /api/backlog/[id]/archive
  • /api/backlog/[id]/restore
  • /api/backlog/[id]/comments
  • /api/backlog/[id]/comments/[commentId]
  • /api/backlog/[id]/create-experiment
  • /api/backlog/[id]/codex-handoff
  • /api/test-results
  • /api/test-results/import/preview
  • /api/test-results/import/confirm

Analytics

Dashboard metrics, exports, experiment stats, behavior analytics, heatmaps, funnels, detected pages, goal suggestions, realtime debugging, traffic, visitors, ecommerce, geo, quality, and semantic learning.

  • /api/analytics/dashboard
  • /api/analytics/dashboard/export
  • /api/analytics/timeseries
  • /api/analytics/experiment/[id]
  • /api/analytics/experiment/[id]/behavior
  • /api/analytics/experiment/[id]/behavior-summary
  • /api/analytics/experiment/[id]/heatmap
  • /api/analytics/experiment/[id]/heatmap/screenshots
  • /api/analytics/full-funnel
  • /api/analytics/funnels
  • /api/analytics/funnels/[id]
  • /api/analytics/funnels/[id]/run
  • /api/analytics/pages
  • /api/analytics/suggest-goals
  • /api/analytics/realtime
  • /api/analytics/traffic
  • /api/analytics/visitors
  • /api/analytics/flow
  • /api/analytics/ecommerce
  • /api/analytics/geo
  • /api/analytics/sessions
  • /api/analytics/entry-exit
  • /api/analytics/measurement-quality
  • /api/analytics/shopify-reconciliation
  • /api/analytics/insights
  • /api/analytics/semantic/findings
  • /api/analytics/semantic/sequences

Advanced products

Landing page generation, page-specific Operator tools, rendering, publish, QA, feature flag lifecycle, and personalization lifecycle.

  • /api/landing-pages
  • /api/landing-pages/[id]
  • /api/landing-pages/[id]/chat
  • /api/landing-pages/[id]/compose
  • /api/landing-pages/[id]/publish
  • /api/landing-pages/[id]/qa
  • /api/landing-pages/[id]/versions/[versionId]/render
  • /api/landing-pages/preview/[versionId]
  • /api/flags
  • /api/flags/[id]
  • /api/flags/[id]/activate
  • /api/flags/[id]/pause
  • /api/flags/[id]/archive
  • /api/personalizations
  • /api/personalizations/[id]
  • /api/personalizations/[id]/activate
  • /api/personalizations/[id]/pause
  • /api/personalizations/[id]/archive

Installation, Shopify, edge, and jobs

Install verification, shop switching, runtime settings, Shopify OAuth/pixel/settings/snippet/checkout-blocks, and cron maintenance.

  • /api/onboarding/verify-install
  • /api/shops
  • /api/shops/switch
  • /api/shops/runtime-settings
  • /api/shops/auto-stop
  • /api/shopify/auth
  • /api/shopify/auth/callback
  • /api/shopify/claim
  • /api/shopify/webhooks
  • /api/shopify/settings
  • /api/shopify/snippet
  • /api/shopify/checkout-blocks/config
  • /api/cron/cleanup-webhooks
  • /api/cron/archive-experiments
  • /api/cron/ops-check

Workspace, team, API access, webhooks, privacy, and health

User profile, workspace and team membership, invitations, ownership transfer, API key management, webhook management, privacy exports/deletion, audit logs, and health checks.

  • /api/account/profile
  • /api/orgs
  • /api/orgs/switch
  • /api/orgs/[orgId]
  • /api/orgs/[orgId]/members
  • /api/orgs/[orgId]/members/[id]
  • /api/orgs/[orgId]/invitations
  • /api/orgs/[orgId]/invitations/[id]
  • /api/orgs/[orgId]/leave
  • /api/orgs/[orgId]/transfer-ownership
  • /api/org-invitations/accept
  • /api/org-invitations/decline
  • /api/invitations/accept
  • /api/invitations/decline
  • /api/team/members
  • /api/team/members/[id]
  • /api/team/invitations
  • /api/team/invitations/[id]
  • /api/team/leave
  • /api/team/transfer-ownership
  • /api/api-keys
  • /api/api-keys/[id]
  • /api/v1/webhooks
  • /api/v1/webhooks/[id]
  • /api/v1/data-export
  • /api/v1/data-deletion
  • /api/audit-logs
  • /api/health
  • /api/health/deep

Public API v1

External automation API authenticated by Apex API keys. It includes experiment CRUD, harness sessions, and Apex CLI workspace checkout, file sync, build, and revision routes. The generated endpoint reference below expands these methods from the OpenAPI spec.

  • /api/v1/openapi.json
  • /api/v1/experiments
  • /api/v1/experiments/[id]
  • /api/v1/experiments/[id]/start
  • /api/v1/experiments/[id]/pause
  • /api/v1/experiments/[id]/complete
  • /api/v1/experiments/[id]/duplicate
  • /api/v1/experiments/[id]/screenshots
  • /api/v1/experiments/[id]/variations/[variationId]/workspace
  • /api/v1/experiments/[id]/variations/[variationId]/files
  • /api/v1/experiments/[id]/variations/[variationId]/files/[...path]
  • /api/v1/experiments/[id]/variations/[variationId]/build
  • /api/v1/experiments/[id]/variations/[variationId]/revisions
  • /api/v1/experiments/[id]/variations/generate
  • /api/v1/experiments/by-slug/[slug]
  • /api/v1/experiments/conflicts
  • /api/v1/experiments/generate
  • /api/v1/variations
  • /api/v1/variations/[id]
  • /api/v1/goals
  • /api/v1/goals/[id]
  • /api/v1/screenshots/[jobId]
  • /api/v1/harness/sessions
  • /api/v1/harness/sessions/[id]/versions
  • /api/v1/harness/sessions/[id]/publish