statsig Autotunes API
Manage autotune configurations that automatically optimize parameter values based on a target metric.
Operations 26
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“Which autotunes are set up in my Statsig project?”
“What automatic optimization tests do we currently have configured?”
Tell an agent
List all autotunes in my project.
Show me every autotune configuration we have.
Ask an LLM
“How do I set up an autotune that automatically picks the best variant?”
“Can an autotune optimize toward a specific success metric like checkouts?”
Tell an agent
Create an autotune named {name} that optimizes for {successMetric}.
Set up autotune {name} optimizing {successMetric} across variants {variants}.
Ask an LLM
“Can I page through our autotune experiments through the Console API v1?”
“Which console endpoint lists autotunes a few at a time?”
Tell an agent
List autotunes via the Console API.
Show page {page} of autotunes, {limit} per page.
Ask an LLM
“Can I create an autotune that optimizes for an event such as a purchase?”
“What exploration and attribution windows does a new autotune need?”
Tell an agent
Create autotune {name}: variants {variants}, event {successEvent}, explore {explorationWindow}, attribute {attributionWindow}, threshold {winnerThreshold}.
Create contextual autotune {name} using features {featureList}.
Ask an LLM
“What variants and success event is a particular autotune using?”
“Can I look up the settings of one autotune experiment?”
Tell an agent
Read autotune {id}.
Show the variants and windows configured on autotune {id}.
Ask an LLM
“Can I resend every setting of an autotune in one update?”
“Which call overwrites an autotune's variants, windows and winner threshold together?”
Tell an agent
Fully update autotune {id} with variants {variants}, event {successEvent}, windows {explorationWindow} and {attributionWindow}, threshold {winnerThreshold}.
Overwrite all settings of autotune {id}.
PATCH
/console/v1/autotunes/{id}
Change selected settings on an autotune · Partially Update Autotune
#
Ask an LLM
“Can I change just the winner threshold of a running autotune?”
“Is it possible to update only the description or exploration window of an autotune?”
Tell an agent
Set the winner threshold of autotune {id} to {winnerThreshold}.
Change autotune {id}'s exploration window to {explorationWindow}.
Ask an LLM
“Can I permanently remove an autotune I no longer need?”
“What deletes an autotune experiment from the project?”
Tell an agent destructive · confirm first
Delete autotune {id}.
Remove autotune {id} from the project.
PUT
/console/v1/autotunes/{id}/make_decision
Finish an autotune early with a decision · Finish Experiment Early
#
Ask an LLM
“Can I end an autotune early and ship a chosen variant?”
“Is a reason required when I make an early decision on an autotune?”
Tell an agent
Finish autotune {id} early choosing group {decision} because {decisionReason}.
Make a final decision on autotune {id}: ship {decision}, reason {decisionReason}.
GET
/console/v1/autotunes/{id}/overrides
Get the overrides on an autotune · Get Autotune Overrides
#
Ask an LLM
“Which users are forced into a particular variant of an autotune?”
“Can I see the gate, segment and user ID overrides on one autotune?”
Tell an agent
Show the overrides on autotune {id}.
List who is forced into a variant on autotune {id}.
POST
/console/v1/autotunes/{id}/overrides
Replace all overrides on an autotune · Update Autotune Overrides
#
Ask an LLM
“Can I replace an autotune's whole override list with a new set?”
“Which call resets an autotune's user ID overrides to exactly what I send?”
Tell an agent
Replace the overrides on autotune {id} with {overrides} and user ID overrides {userIDOverrides}.
Overwrite autotune {id}'s user ID overrides with {userIDOverrides} and other overrides with {overrides}.
PATCH
/console/v1/autotunes/{id}/overrides
Add overrides to an autotune · Partially Update Autotune Overrides
#
Ask an LLM
“Can I add a few more overrides to an autotune while keeping the existing ones?”
“How do I force extra user IDs into an autotune variant without resetting the list?”
Tell an agent
Add overrides {overrides} and user ID overrides {userIDOverrides} to autotune {id}.
Append user ID overrides {userIDOverrides} to autotune {id}, plus {overrides}.
DELETE
/console/v1/autotunes/{id}/overrides
Remove all overrides from an autotune · Delete Autotune Overrides
#
Ask an LLM
“Can I clear every override from an autotune at once?”
“What stops all forced variant assignments on an autotune?”
Tell an agent destructive · confirm first
Delete all overrides on autotune {id}.
Clear every forced assignment from autotune {id}.
DELETE
/console/v1/autotunes/{id}/overrides/conditional/{type}/{name}
Remove one gate or segment override from an autotune · Delete a Single Autotune Override
#
Ask an LLM
“Can I remove a single gate or segment override from an autotune?”
“Is it safe to delete a segment override that may not exist on the autotune?”
Tell an agent destructive · confirm first
Remove the {type} override {name} from autotune {id} in group {groupID}.
Delete segment or gate override {name} of type {type} on autotune {id}, group {groupID}, in environment {environment}.
DELETE
/console/v1/autotunes/{id}/overrides/userID/{userID}
Remove one user ID override from an autotune · Delete a Single Autotune User ID Override
#
Ask an LLM
“Can I take just one user out of an autotune's override bucket?”
“Can a user ID override on an autotune be removed for a single environment?”
Tell an agent destructive · confirm first
Remove user {userID} from override group {groupID} on autotune {id}.
Stop overriding user {userID} on autotune {id} in group {groupID} for environment {environment}.
Ask an LLM
“Can I reset an autotune so it starts learning again?”
“What restarts an autotune experiment from scratch?”
Tell an agent destructive · confirm first
Reset autotune {id}.
Restart autotune {id} from the beginning.
Ask an LLM
“Which change reviews have been requested on an autotune?”
“Can I page through the review history of one autotune?”
Tell an agent
List the reviews on autotune {id}.
Show page {page} of change reviews for autotune {id}.
POST
/console/v1/autotunes/{id}/reviews
Request a review of an autotune change · Create Autotune Review
#
Ask an LLM
“Can I send an autotune change, such as starting it or shipping a winner, for approval?”
“Is it possible to assign particular reviewers to an autotune change request?”
Tell an agent
Request a {type} review on autotune {id}.
Open a {type} review on autotune {id} for reviewers {reviewer_ids} with description {description}.
GET
/console/v1/autotunes/{id}/reviews/{reviewID}
Get one review on an autotune · Get Autotune Review
#
Ask an LLM
“What is the status of a specific review on an autotune?”
“Can I look up a single autotune change review by its ID?”
Tell an agent
Get review {reviewID} on autotune {id}.
Show the details of autotune {id} review {reviewID}.
PUT
/console/v1/autotunes/{id}/reviews/{reviewID}
Edit a pending autotune review · Edit Autotune Review
#
Ask an LLM
“Can I change the reviewers assigned to an open autotune review?”
“Is it possible to edit the description of an autotune review after creating it?”
Tell an agent
Set the reviewers on autotune {id} review {reviewID} to {reviewer_ids}.
Update review {reviewID} on autotune {id} with description {description}.
DELETE
/console/v1/autotunes/{id}/reviews/{reviewID}
Cancel a pending autotune review · Cancel Autotune Review
#
Ask an LLM
“Can I withdraw an autotune change request that is still awaiting review?”
“What cancels an autotune review we no longer need?”
Tell an agent destructive · confirm first
Cancel review {reviewID} on autotune {id}.
Withdraw autotune {id}'s pending review {reviewID}.
PUT
/console/v1/autotunes/{id}/reviews/{reviewID}/approve
Approve an autotune change review · Approve Autotune Review
#
Ask an LLM
“Can I approve a proposed autotune change through the API?”
“Is there a way to leave a reason when approving an autotune review?”
Tell an agent
Approve review {reviewID} on autotune {id}.
Approve autotune {id} review {reviewID} with reason {reason}.
PUT
/console/v1/autotunes/{id}/reviews/{reviewID}/commit
Commit an approved autotune change · Commit Autotune Review
#
Ask an LLM
“After an autotune review is approved, what applies the change?”
“Can I commit an approved autotune change so it takes effect?”
Tell an agent
Commit review {reviewID} on autotune {id}.
Apply the approved change from review {reviewID} to autotune {id}.
PUT
/console/v1/autotunes/{id}/reviews/{reviewID}/reject
Reject an autotune change review · Reject Autotune Review
#
Ask an LLM
“Can I turn down a proposed autotune change and say why?”
“Is a reason required when rejecting an autotune review?”
Tell an agent
Reject review {reviewID} on autotune {id} because {reason}.
Decline autotune {id} change request {reviewID} with reason {reason}.
POST
/console/v1/autotunes/{id}/schedule_start
Schedule an autotune to start later · Schedule Autotune Start
#
Ask an LLM
“Can I schedule an autotune to begin at a set time?”
“Is it possible to queue an autotune launch for next Monday morning?”
Tell an agent
Schedule autotune {id} to start at {scheduledTime}.
Set autotune {id}'s start time to {scheduledTime}.
Ask an LLM
“Can I start an autotune experiment right away?”
“What begins exploration on an autotune I just configured?”
Tell an agent
Start autotune {id} now.
Begin running autotune {id} immediately.