Skip to main content
POST
Re-run a stored taxonomy analytics run

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Path Parameters

taxonomy_id
string
required
run_id
string
required

Response

Successful Response

API response model for step transition analytics.

Contains comprehensive statistics about the A→B transition including conversion metrics, duration analysis, and predictor insights.

Example Response: json { "from_step": "inquiry", "to_step": "closed_won", "count": 1000, "converted": 350, "conversion_rate": 0.35, "durations_sec": { "mean": 432000.0, "median": 345600.0, "p50": 345600.0, "p90": 691200.0, "p95": 864000.0, "std_dev": 172800.0, "min": 86400.0, "max": 1209600.0 }, "top_predictors": [ { "field": "Sender Domain", "value": "enterprise.com", "count": 150, "conversion_rate": 0.75, "lift": 2.14 } ], "metadata": { "collection_id": "col_emails", "taxonomy_id": "tax_sales_stages", "total_events_analyzed": 5432 } }

from_step
string
required

Starting step

to_step
string
required

Ending step

count
integer
required

Total number of sequences starting at from_step

Required range: x >= 0
converted
integer
required

Number of sequences that reached to_step

Required range: x >= 0
conversion_rate
number
required

Percentage that converted (converted / count)

Required range: 0 <= x <= 1
durations_sec
DurationStats · object | null

Duration statistics (None if no conversions)

top_predictors
PredictorLift · object[]

Covariates with highest lift (sorted by absolute lift)

Maximum array length: 50
metadata
Metadata · object

Additional metadata (collection_id, event counts, etc.)