---
title: "Re-run a stored taxonomy analytics run"
method: POST
path: "/v1/taxonomies/{taxonomy_id}/analytics/runs/{run_id}/rerun"
tags: ["Taxonomy Analytics"]
---

# Re-run a stored taxonomy analytics run

`POST /v1/taxonomies/{taxonomy_id}/analytics/runs/{run_id}/rerun`

## Request

- Base URL: `https://api.mixpeek.com`
- URL: `https://api.mixpeek.com/v1/taxonomies/{taxonomy_id}/analytics/runs/{run_id}/rerun`
- Auth: HTTP bearer and API key in header `X-Namespace`

Re-execute a previously persisted analytics run using its stored parameters and return the FRESH result. The stored run is updated in place with the new result (run_count is incremented).

## Path parameters

- `taxonomy_id` string, required
- `run_id` string, required

## Response `200`

Successful Response

- union
  - StepTransitionResponse: 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
    - `converted` integer, required: Number of sequences that reached to_step
    - `conversion_rate` number, required: Percentage that converted (converted / count)
    - `durations_sec` DurationStats: Statistical distribution of durations for successful step transitions. Provides comprehensive percentile analysis to understand timing patterns. Attributes: mean: Average duration (seconds) median: Middle value (50th percentile) p50: 50th percentile (same as median, included for consistency) p90: 90th percentile (90% complete faster) p95: 95th percentile (95% complete faster) std_dev: Standard deviation (measure of spread) min: Fastest observed duration max: Slowest observed duration Example: ```python DurationStats( mean=432000.0, # 5 days average median=345600.0, # 4 days median p50=345600.0, p90=691200.0, # 8 days (90th percentile) p95=864000.0, # 10 days (95th percentile) std_dev=172800.0, # 2 days std dev min=86400.0, # 1 day minimum max=1209600.0 # 14 days maximum ) ```
      - `mean` number, required: Average duration in seconds
      - `median` number, required: Median duration in seconds
      - `p50` number, required: 50th percentile (same as median)
      - `p90` number, required: 90th percentile duration in seconds
      - `p95` number, required: 95th percentile duration in seconds
      - `std_dev` number, required: Standard deviation in seconds
      - `min` number, required: Minimum duration observed in seconds
      - `max` number, required: Maximum duration observed in seconds
    - `top_predictors` PredictorLift[]: Covariates with highest lift (sorted by absolute lift)
      - `field` string, required: Covariate field name
      - `value` string, required: Specific value or bin label
      - `count` integer, required: Number of sequences with this value
      - `conversion_rate` number, required: Conversion rate for this value
      - `lift` number, required: Lift relative to baseline (>1.0 = positive, <1.0 = negative)
    - `metadata` object: Additional metadata (collection_id, event counts, etc.)
  - PathAnalysisResponse: API response model for multi-step path analysis. Contains discovered transition paths with frequency and duration statistics. Example Response: ```json { "from_step": "inquiry", "to_step": "closed_won", "total_sequences": 1000, "completed_sequences": 350, "completion_rate": 0.35, "paths": [ { "path": ["inquiry", "followup", "proposal", "closed_won"], "count": 120, "percentage": 34.3, "avg_duration_sec": 604800.0 }, { "path": ["inquiry", "proposal", "closed_won"], "count": 90, "percentage": 25.7, "avg_duration_sec": 432000.0 }, { "path": ["inquiry", "closed_won"], "count": 70, "percentage": 20.0, "avg_duration_sec": 172800.0 } ] } ```
    - `from_step` string, required
    - `to_step` string, required
    - `total_sequences` integer, required: Total sequences that started at from_step
    - `completed_sequences` integer, required: Number of sequences that reached to_step
    - `completion_rate` number, required: Percentage that completed the path
    - `paths` TransitionPath[], required: List of paths sorted by frequency (most common first)
      - `path` string[], required: Ordered sequence of steps
      - `count` integer, required: Number of sequences following this path
      - `percentage` number, required: Percentage of total completing sequences
      - `avg_duration_sec` number, nullable: Average time to complete this path (seconds)

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `success` to the response with the `422` status
  - …2 more
- **2026-08-09** `5d4c905106b4`: 1 info
  - the endpoint scheme security `BearerAuth AND NamespaceHeader` was added to the API

[Operation history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/taxonomies/:taxonomy_id/analytics/runs/:run_id/rerun/post.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) - [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixpeek/apis/mixpeek-api/revisions/790bc16455f6?raw)