{"service":"Mixpanel Power Tools API","version":"1.0.0","documentation":"GET any endpoint path for detailed documentation (no authentication required). POST requests require authentication to execute.","authentication":"POST endpoints accept any valid Mixpanel credentials (Bearer OAuth token or Basic service account) and act with the caller's own Mixpanel permissions. Exception: AI endpoints (/macro/ai-* and /macro/mixpanel-md) are restricted to Mixpanel employees or service accounts.","auth":{"endpoint":"/auth","description":"Verify credentials and optionally check project access. POST with project_id to test project-level permissions and get workspace metadata. GET /auth for documentation."},"auth_projects":{"endpoint":"/auth/projects","description":"Enumerate every Mixpanel project accessible to the credentials, across all orgs. POST with optional region. GET /auth/projects for documentation."},"reference_urls":{"endpoint":"/reference/urls","description":"Canonical Mixpanel URL family reference grouped by domain (auth, dashboards, cohorts, etc.). GET only — no authentication required."},"api_surfaces":{"agents":{"endpoint":"/agents","description":"Conversational AI agents (Tool, Dash, Insights, RCA, Funnel). POST /agents/:type to create a session, then connect via WebSocket. GET /agents for full documentation."},"query":{"endpoint":"/query","description":"Direct access to Mixpanel query methods with intelligent caching. GET /query for full documentation."},"crud":{"endpoint":"/crud","description":"Direct CRUD operations on project entities (dashboards, cohorts, reports, etc.). GET /crud for full documentation."},"ingestion":{"endpoint":"/ingestion","description":"Data-in primitives: import events / user & group profiles / lookup tables via the mixpanel-import SDK (vendor formats, transforms, dry runs). GET /ingestion for full documentation."},"export":{"endpoint":"/export","description":"Data-out primitives: export events and profiles (mixpanel-import exporters + raw export). GET /export for full documentation."},"deletion":{"endpoint":"/deletion","description":"Data deletion: Lexicon soft-delete (event deletion-requests) and GDPR hard-delete v3.0 (+ data retrieval). GET /deletion for full documentation."},"macro":{"endpoint":"/macro","description":"All macro endpoints live under /macro/. Example: /macro/ai-schema, /macro/clone-project"}},"global_optional_params":{"user_id":"Client-side user identifier for observability tracking (use mixpanel.get_distinct_id() from frontend). Falls back to \"anonymous\" if not provided.","client_id":"Client application identifier for tracking API usage by integration/app (e.g., \"my-app-v1\", \"internal-tool\")."},"duration_ms":2,"duration_human":"0 seconds"}