PIpioneer
experiments

Get Experiment metadata

Changed on

Read Experiment metadata as its creator or an Owner/Admin.

Args: experiment_id: Experiment identifier. auth: Authenticated caller.

Returns: Authorized metadata.

get/v1/experiments/{experiment_id}

Request

Path parameters

experiment_idstring uuid required

Response

Successful Response

idstring required
project_idstring required
project_version_idstring nullable required
team_idstring required
session_idstring nullable

Creator-only transcript session identifier.

created_bystring required
titlestring nullable required
mode'mle_agent' | 'auto_agent' required

Which agent drives an Experiment's conversation (EDD section 0.2).

stage'scoping' | 'preparing_data' | 'training' | 'evaluating' | 'complete' | 'blocked' | 'cancelled' required

Agent-owned workflow stage of an Experiment (EDD section 0.2).

mode_locked_atstring date-time nullable required
last_activity_atstring date-time required
completed_atstring date-time nullable required
completion_outcome'incumbent_retained' | 'candidate_promoted'

Why a COMPLETE Experiment ended (EDD 8.1).

A closed set rather than free text because it is the thing that makes "the incumbent is already good enough" a queryable success instead of one inferred from the absence of a promoted model -- and an unvalidated string column cannot be counted on for that. Sits beside ExperimentStage and ExperimentMode, which back the two other lifecycle discriminators on the same table.

cancelled_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required

Changes