Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

The Scenario ID.

Body

application/json

ScenarioUpdateParameters contain the set of parameters to update a Scenario. All fields are optional - null fields preserve existing values, provided fields replace entirely.

name
string | null

Name of the scenario. Cannot be blank.

input_context
object | null

The input context for the Scenario.

scoring_contract
object | null

The scoring contract for the Scenario.

environment_parameters
object | null

The Environment in which the Scenario will run.

metadata
object | null

User defined metadata to attach to the scenario. Pass in empty map to clear.

required_environment_variables
string[] | null

Environment variables required to run the scenario. Pass in empty list to clear.

required_secret_names
string[] | null

Secrets required to run the scenario. Pass in empty list to clear.

reference_output
string | null

A string representation of the reference output to solve the scenario. Commonly can be the result of a git diff or a sequence of command actions to apply to the environment. Pass in empty string to clear.

validation_type
enum<string> | null

Validation strategy. Pass in empty string to clear.

Available options:
UNSPECIFIED,
FORWARD,
REVERSE,
EVALUATION
scorer_timeout_sec
integer<int32> | null

Timeout for scoring in seconds. Default 30 minutes (1800s).

Response

200 - application/json

OK

A ScenarioDefinitionView represents a repeatable AI coding evaluation test, complete with initial environment and scoring contract.

id
string
required

The ID of the Scenario.

name
string
required

The name of the Scenario.

input_context
object
required

The input context for the Scenario.

scoring_contract
object
required

The scoring contract for the Scenario.

metadata
object
required

User defined metadata to attach to the scenario for organization.

status
enum<string>
required

Whether the scenario is active or archived. Archived scenarios are excluded from listings and cannot be updated.

Available options:
active,
archived
environment
object | null

The Environment in which the Scenario is run.

reference_output
string | null

A string representation of the reference output to solve the scenario. Commonly can be the result of a git diff or a sequence of command actions to apply to the environment.

required_environment_variables
string[]

Environment variables required to run the scenario. If any required environment variables are missing, the scenario will fail to start.

required_secret_names
string[]

Environment variables required to run the scenario. If any required secrets are missing, the scenario will fail to start.

is_public
boolean

Whether this scenario is public.

validation_type
enum<string> | null

Validation strategy.

Available options:
UNSPECIFIED,
FORWARD,
REVERSE,
EVALUATION
scorer_timeout_sec
integer<int32> | null

Timeout for scoring in seconds. Default 30 minutes (1800s).