autoresearch
autoresearch

List and retrieve champion/challenger models for a pipeline.

Models are the persisted artifacts produced by training runs. Each model holds a portable recipe (feature SQL, transforms, model class, params) that the daily inference workflow compiles to score users.

get/api/projects/{project_id}/autoresearch/{pipeline_id}/models/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/autoresearch/{pipeline_id}/models/
  • Auth: HTTP bearer

Path parameters

pipeline_idstring uuid required
project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Query parameters

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

Response

countinteger required
nextstring uri nullable
previousstring uri nullable

Example response

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "model_recipe": {
        "feature_sql": "SELECT a.person_id AS distinct_id, countIf(e.event='$pageview') AS pageviews_30d FROM {anchors} a LEFT JOIN events e ON e.person_id = a.person_id AND e.timestamp < fromUnixTimestamp(a.cutoff_ts) GROUP BY a.person_id",
        "feature_transforms": [],
        "model_class": "sklearn.linear_model.LogisticRegression",
        "model_params": {
          "C": 1,
          "max_iter": 200
        },
        "fit_signature": "abc123",
        "trained_on": "2026-04-01 to 2026-05-01",
        "holdout_score": 0.72,
        "agent_description": "Stub recipe: universal engagement features"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.