# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Harness Experiments API version: 1.0.0 extends: openapi/harness-experiments-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 34 - target: $.paths['/gateway/chaos/manager/api/rest/chaos-experiment-run/report/{experimentRunId}/{notifyId}'].get update: x-apievangelist-phrasing: intent: Get the report for a Kubernetes chaos experiment run effect: read questions: - Can I pull a generated report for a finished kubernetesV1 chaos experiment run? - What does the run report for a Kubernetes chaos experiment contain once it completes? instructions: - text: Generate the Kubernetes chaos run report for run {run_id} with notify id {notify_id}. slots: run_id: path.experimentRunId notify_id: path.notifyId - text: Fetch the kubernetesV1 experiment run report for run {run_id} and notify id {notify_id} in project {project}. slots: run_id: path.experimentRunId notify_id: path.notifyId project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/overview/experiment-stats'].get update: x-apievangelist-phrasing: intent: Get chaos experiment run overview statistics effect: read questions: - How many chaos experiment runs passed or failed over the last month? - Can I group chaos experiment run statistics over a time window? instructions: - text: Show chaos experiment run stats for project {project} between {start} and {end}. slots: project: query.projectIdentifier start: query.startTime end: query.endTime - text: Summarize experiment run counts grouped by {group_by}. slots: group_by: query.groupBy method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/bulkaction/bulkexperimentdelete'].post update: x-apievangelist-phrasing: intent: Delete several chaos experiments at once effect: destructive questions: - Can I remove a batch of chaos experiments in one call instead of one by one? - Is there a bulk action to clean out old chaos experiments from a project? instructions: - text: Bulk delete chaos experiments {experiment_ids} from project {project}. slots: experiment_ids: requestBody.experimentIDs project: query.projectIdentifier - text: 'Remove all of these experiments in one go: {experiment_ids}.' slots: experiment_ids: requestBody.experimentIDs method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/bulkaction/bulkexperimenttagsadd'].post update: x-apievangelist-phrasing: intent: Add tags to several chaos experiments effect: write questions: - How do I tag many chaos experiments at the same time? - Can tags be applied to a batch of experiments in a single request? instructions: - text: Add tags {tags} to experiments {experiment_ids}. slots: tags: requestBody.tags experiment_ids: requestBody.experimentIDs - text: Bulk tag the chaos experiments {experiment_ids} in project {project} with {tags}. slots: experiment_ids: requestBody.experimentIDs project: query.projectIdentifier tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/chaos-pipeline/step/{experimentId}/{experimentRunId}/{stepName}'].get update: x-apievangelist-phrasing: intent: Get one step of a chaos pipeline execution effect: read questions: - What happened in a specific step of a chaos pipeline run? - Can I inspect a single named step inside a chaos experiment's pipeline execution? instructions: - text: Show step {step} of run {run_id} for chaos experiment {experiment_id}. slots: step: path.stepName run_id: path.experimentRunId experiment_id: path.experimentId - text: Get the execution details of pipeline step {step} in experiment {experiment_id}, run {run_id}, project {project}. slots: step: path.stepName experiment_id: path.experimentId run_id: path.experimentRunId project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/chaos-pipeline/{experimentId}'].get update: x-apievangelist-phrasing: intent: Get the pipeline execution of a chaos experiment run effect: read questions: - Where can I see the whole pipeline execution behind a chaos experiment run? - Which steps ran in the chaos pipeline for a given experiment run? instructions: - text: Get the chaos pipeline execution for experiment {experiment_id}, run {run_id}, notify id {notify_id}. slots: experiment_id: path.experimentId run_id: query.experimentRunId notify_id: query.notifyId - text: Show the full pipeline for run {run_id} of chaos experiment {experiment_id}. slots: run_id: query.experimentRunId experiment_id: path.experimentId method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiment'].get update: x-apievangelist-phrasing: intent: List chaos experiments in a project effect: read questions: - Which chaos experiments exist in my project? - Can I list chaos experiments targeting a particular infrastructure or with a given status? - How do I find chaos experiments created within a date range? instructions: - text: List the chaos experiments in project {project}, page {page}, {limit} per page. slots: project: query.projectIdentifier page: query.page limit: query.limit - text: List chaos experiments on infrastructure {infra_id} with status {status}. slots: infra_id: query.infraId status: query.status - text: Find chaos experiments named {name}. slots: name: query.experimentName method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiment'].post update: x-apievangelist-phrasing: intent: Create or save a chaos experiment effect: write questions: - How do I create a new chaos experiment from a manifest? - Can I save a chaos experiment with a cron schedule so it runs automatically? instructions: - text: Save a chaos experiment named {name} on infrastructure {infra_id} using manifest {manifest}. slots: name: requestBody.name infra_id: requestBody.infraId manifest: requestBody.manifest - text: Create chaos experiment {name} scheduled with cron {cron}. slots: name: requestBody.name cron: requestBody.cronSyntax method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiment-runs/csv'].post update: x-apievangelist-phrasing: intent: Export chaos experiment runs as CSV effect: read questions: - Can I download my chaos experiment run history as a spreadsheet? - Is there a CSV export of experiment runs for a time range? instructions: - text: Download experiment runs from {start} to {end} as CSV for account {account}. slots: start: query.startTime end: query.endTime account: query.accountIdentifier - text: Export a CSV of chaos runs matching {search}. slots: search: query.search method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiment/bulk/run'].post update: x-apievangelist-phrasing: intent: Create a pipeline that runs experiments in bulk effect: write questions: - Can I run several chaos experiments together through one generated pipeline? - What do I need to set up a bulk-run pipeline for chaos experiments? instructions: - text: Create a bulk-run pipeline named {name} with identifier {identifier} for experiments {spec}. slots: name: requestBody.name identifier: requestBody.identifier spec: requestBody.experimentSpec - text: 'Build a pipeline in project {project} that runs these chaos experiments in bulk: {spec}.' slots: project: query.projectIdentifier spec: requestBody.experimentSpec method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiment/cron'].post update: x-apievangelist-phrasing: intent: Change the cron schedule of chaos experiments effect: write questions: - How do I change when a scheduled chaos experiment runs? - Can I enable or disable the cron schedule on several experiments at once? instructions: - text: Set the cron schedule of experiments {experiment_ids} to {cron}. slots: experiment_ids: requestBody.experimentIDs cron: requestBody.cronSyntax - text: Apply cron action {action} to scheduled experiments {experiment_ids}. slots: action: requestBody.action experiment_ids: requestBody.experimentIDs method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiment/{experimentId}'].delete update: x-apievangelist-phrasing: intent: Delete a chaos experiment effect: destructive questions: - How do I permanently remove a single chaos experiment? - What happens to a chaos experiment when I delete it from the project? instructions: - text: Delete chaos experiment {experiment_id}. slots: experiment_id: path.experimentId - text: Remove experiment {experiment_id} from project {project}. slots: experiment_id: path.experimentId project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiment/{experimentId}/stop'].post update: x-apievangelist-phrasing: intent: Stop a running chaos experiment effect: destructive questions: - How do I halt a chaos experiment that is currently running? - Can I force-stop a chaos run that is stuck? instructions: - text: Stop run {run_id} of chaos experiment {experiment_id} with notify id {notify_id}. slots: run_id: query.experimentRunId experiment_id: path.experimentId notify_id: query.notifyId - text: Force stop experiment {experiment_id} run {run_id} (force={force}). slots: experiment_id: path.experimentId run_id: query.experimentRunId force: query.force method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments'].post update: x-apievangelist-phrasing: intent: Search experiments with filters and sorting effect: read questions: - Can I filter and sort experiments by workflow or identity in one query? - Which experiments match a set of identities I already have? instructions: - text: Search experiments in project {project} using filter {filter} sorted by {sort}. slots: project: query.projectIdentifier filter: requestBody.filter sort: requestBody.sort - text: Look up the experiments with identities {identities}. slots: identities: requestBody.identities method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/timeline/run/{experimentId}'].get update: x-apievangelist-phrasing: intent: Get the timeline of a chaos experiment run effect: read questions: - What is the step-by-step timeline of a chaos experiment run? - Can I see when each fault started and ended during a run? instructions: - text: Show the timeline for run {run_id} of experiment {experiment_id}. slots: run_id: query.experimentRunId experiment_id: path.experimentId - text: Get the timeline view of the latest run of chaos experiment {experiment_id}. slots: experiment_id: path.experimentId method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}'].get update: x-apievangelist-phrasing: intent: Get a chaos experiment's definition effect: read questions: - What faults and infrastructure does a specific chaos experiment use? - Can I look up a chaos experiment by its ID? instructions: - text: Get chaos experiment {experiment_id}. slots: experiment_id: path.experimentId - text: Show the definition of experiment {experiment_id} in project {project}. slots: experiment_id: path.experimentId project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/inputsets'].get update: x-apievangelist-phrasing: intent: List input sets of a chaos experiment effect: read questions: - Which input sets have been saved for a chaos experiment? - Can I page through all the input sets on one experiment? instructions: - text: List input sets for experiment {experiment_id}, page {page}, {limit} per page. slots: experiment_id: path.experimentId page: query.page limit: query.limit - text: Show every saved input set on chaos experiment {experiment_id}. slots: experiment_id: path.experimentId method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/inputsets'].post update: x-apievangelist-phrasing: intent: Create an input set for a chaos experiment effect: write questions: - How do I save a reusable set of runtime inputs for a chaos experiment? - Can I store different input values to rerun an experiment with? instructions: - text: Create input set {name} on experiment {experiment_id} with spec {spec}. slots: name: requestBody.name experiment_id: path.experimentId spec: requestBody.spec - text: Add a new input set with identity {identity} to chaos experiment {experiment_id}. slots: identity: requestBody.identity experiment_id: path.experimentId method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/inputsets/{inputsetId}'].get update: x-apievangelist-phrasing: intent: Get one input set of a chaos experiment effect: read questions: - What values are stored in a particular input set of an experiment? - Can I view one experiment input set by its ID? instructions: - text: Get input set {inputset_id} of experiment {experiment_id}. slots: inputset_id: path.inputsetId experiment_id: path.experimentId - text: Show the spec saved in input set {inputset_id} for chaos experiment {experiment_id}. slots: inputset_id: path.inputsetId experiment_id: path.experimentId method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/inputsets/{inputsetId}'].put update: x-apievangelist-phrasing: intent: Update an input set of a chaos experiment effect: write questions: - How do I change the values in an existing experiment input set? - Can I rename an input set I already saved on an experiment? instructions: - text: Update input set {inputset_id} on experiment {experiment_id} with spec {spec}. slots: inputset_id: path.inputsetId experiment_id: path.experimentId spec: requestBody.spec - text: Rename input set {inputset_id} of experiment {experiment_id} to {name}. slots: inputset_id: path.inputsetId experiment_id: path.experimentId name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/inputsets/{inputsetId}'].delete update: x-apievangelist-phrasing: intent: Delete an input set from a chaos experiment effect: destructive questions: - How do I get rid of an input set I no longer use on an experiment? - Does deleting an experiment input set remove it permanently? instructions: - text: Delete input set {inputset_id} from experiment {experiment_id}. slots: inputset_id: path.inputsetId experiment_id: path.experimentId - text: Remove saved inputs {inputset_id} on chaos experiment {experiment_id} in project {project}. slots: inputset_id: path.inputsetId experiment_id: path.experimentId project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/run'].get update: x-apievangelist-phrasing: intent: Get the result of a chaos experiment run effect: read questions: - Did my last chaos experiment run pass or fail? - What is the resiliency score of a specific experiment run? instructions: - text: Get run {run_id} of chaos experiment {experiment_id}. slots: run_id: query.experimentRunId experiment_id: path.experimentId - text: Show the outcome of the run with notify id {notify_id} for experiment {experiment_id}. slots: notify_id: query.notifyId experiment_id: path.experimentId method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/run'].post update: x-apievangelist-phrasing: intent: Run a chaos experiment effect: write questions: - How do I trigger a chaos experiment to run now? - Can I launch an experiment using a saved input set or runtime inputs? instructions: - text: Run chaos experiment {experiment_id}. slots: experiment_id: path.experimentId - text: Start experiment {experiment_id} using input set {inputset}. slots: experiment_id: path.experimentId inputset: requestBody.inputsetIdentity - text: Kick off experiment {experiment_id} with runtime inputs {inputs}. slots: experiment_id: path.experimentId inputs: requestBody.runtimeInputs method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/experiments/{experimentId}/variables'].get update: x-apievangelist-phrasing: intent: Get the variables of a chaos experiment effect: read questions: - Which variables does a chaos experiment expect before it runs? - Can I see the runtime inputs an experiment needs? instructions: - text: List the variables of chaos experiment {experiment_id}. slots: experiment_id: path.experimentId - text: Show which inputs experiment {experiment_id} requires in project {project}. slots: experiment_id: path.experimentId project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/note'].patch update: x-apievangelist-phrasing: intent: Edit a note on a chaos experiment or run effect: write questions: - How do I edit a note I already left on a chaos run? - Can I change the comment on an existing experiment note? instructions: - text: Update note {note_id} to say {comment}. slots: note_id: requestBody.noteId comment: requestBody.comment - text: Apply operation {operation} to note {note_id} on experiment {experiment_id}. slots: operation: requestBody.operation note_id: requestBody.noteId experiment_id: requestBody.experimentID method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/notes'].get update: x-apievangelist-phrasing: intent: Read the notes on a chaos experiment or run effect: read questions: - What notes have been left on a chaos experiment run? - Can I read the comments attached to a GameDay run? instructions: - text: Show notes on experiment {experiment_id} run {run_id}. slots: experiment_id: query.experimentId run_id: query.experimentRunId - text: Get the notes for GameDay run {gameday_run}. slots: gameday_run: query.gamedayRunID method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/notes'].post update: x-apievangelist-phrasing: intent: Add a note to a chaos experiment or run effect: write questions: - How do I leave a comment on a chaos experiment run for my team? - Can I attach a note to a GameDay run? instructions: - text: Add note {comment} to run {run_id} of experiment {experiment_id}. slots: comment: requestBody.comment run_id: requestBody.experimentRunID experiment_id: requestBody.experimentID - text: Post a new note {comment} on GameDay run {gameday_run} in project {project}. slots: comment: requestBody.comment gameday_run: requestBody.gamedayRunID project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/pipeline/experiment/runs'].post update: x-apievangelist-phrasing: intent: List chaos runs launched by a pipeline execution effect: read questions: - Which chaos experiment runs did my pipeline execution trigger? - Can I map pipeline notify IDs back to their experiment runs? instructions: - text: List the experiment runs for pipeline notify ids {notify_ids}. slots: notify_ids: requestBody.notifyIDs - text: Show chaos runs triggered by pipelines in project {project} with notify ids {notify_ids}. slots: project: query.projectIdentifier notify_ids: requestBody.notifyIDs method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/rest/v2/pipeline/verify/runs'].get update: x-apievangelist-phrasing: intent: Verify the chaos stage of a pipeline run effect: read questions: - Did the chaos stage in my pipeline execution actually run? - Can I check a specific stage of a pipeline run for chaos results? instructions: - text: Verify the chaos stage {stage} in execution {execution} of pipeline {pipeline}. slots: stage: query.stageID execution: query.executionID pipeline: query.pipelineID - text: Check the chaos stage runs for pipeline execution {execution} in project {project}. slots: execution: query.executionID project: query.projectIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/v1/notification-experiments'].get update: x-apievangelist-phrasing: intent: List experiments on active infrastructure for notifications effect: read questions: - Which experiments run on infrastructure that is currently active, in a minimal format? - What lightweight experiment list does the notification service use? instructions: - text: List experiments with active infrastructures in project {project} for notifications. slots: project: query.projectIdentifier - text: Get the minimal notification list of active-infra experiments named {name}. slots: name: query.experimentName method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/v3/chaos-experiment-run/report/{experimentId}/{chaosExperimentRunId}'].get update: x-apievangelist-phrasing: intent: Get the beta1 report for a chaos experiment run effect: read questions: - Can I generate the newer beta1 report for one run of an experiment? - Where do I get a shareable report for a specific experiment run by experiment ID? instructions: - text: Generate the beta1 run report for experiment {experiment_id}, run {run_id}. slots: experiment_id: path.experimentId run_id: path.chaosExperimentRunId - text: Produce the v3 PDF report for chaos run {run_id} of experiment {experiment_id}. slots: run_id: path.chaosExperimentRunId experiment_id: path.experimentId method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/v3/experiments/list-metadata'].post update: x-apievangelist-phrasing: intent: List metadata for experiments effect: read questions: - Can I get just the metadata of experiments across all scopes? - What tags and names do my experiments carry, without full definitions? instructions: - text: List experiment metadata for identifiers {identifiers}. slots: identifiers: requestBody.identifiers - text: Get experiment metadata tagged {tags} across all scopes for account {account}. slots: tags: query.tags account: query.accountIdentifier method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/v3/integrations/get-experiment-or-template-variable'].get update: x-apievangelist-phrasing: intent: Get the inputs of an experiment or template effect: read questions: - What inputs does an experiment template from a chaos hub require? - Can I fetch variables for either an experiment or a template in one call? instructions: - text: Get the inputs of template {identifier} from hub {hub}. slots: identifier: query.identifier hub: query.hubReference - text: Show integration inputs for experiment {experiment_id} of kind {kind}. slots: experiment_id: query.experimentId kind: query.kind method: generated generated: '2026-09-26' - target: $.paths['/gateway/chaos/manager/api/v3/integrations/list-experiment-or-template'].get update: x-apievangelist-phrasing: intent: List experiments or templates for integrations effect: read questions: - Which experiment templates are available in a chaos hub for my infrastructure type? - Can integrations browse both experiments and templates in one list? instructions: - text: List experiment templates in hub {hub} for infrastructure type {infra_type}. slots: hub: query.hubIdentifier infra_type: query.infraType - text: List integration items of kind {kind} matching {search} for account {account}. slots: kind: query.kind search: query.search account: query.accountIdentifier method: generated generated: '2026-09-26'