v1

latestOpenAPI 3.0.1Gremlin License2026-08-06397451577.0 KB
executions

Get a list of executions associated with an attack.

Requires the privilege EXPERIMENTS_READ

get/executions

Query parameters

taskIdstring
teamIdstring required

Required when using company session token.

Response

default response

orgIdstring

The teamId associated with the execution

guidstring

Unique identifier associated with the execution

targetType'Host' | 'Container' | 'Docker' | 'Kubernetes'
infraTargetobject
clientIdstring

The unique agent identifier associated with the execution. For host-level experiments, this value represents the agent on the host where the execution is running. For container-level experiments, this value represents the agent that is running on the same host as the targeted container.

tagsobject
labelsobject
multiSelectTagsobject
multiSelectLabelsobject
clientStatus'HEALTHY' | 'IMPAIRED' | 'UNHEALTHY'
clientVersionstring
errorstring

If any critical error occurs during the execution's lifecycle, it is stored here.

outputstring

Raw logging output from the gremlin experiment process while the execution runs.

infraCommandobject
guestIdstring

If execution is running against a container target, this field is populated with the containerId

createSource'WebApp' | 'Api' | 'Scheduled' | 'Manual' | 'Spinnaker' | 'Concord' | 'GremlinFeeder' | 'GremlinSdkPython' | 'Scenario' | 'Chao' | 'K8sBackend' | 'Website' | 'Neotys' | 'IntegrationClient' | 'Validation'
attackContainerIdstring
stage'InvalidArgument' | 'TargetNotFound' | 'Successful' | 'UserHalted' | 'ClientAborted' | 'LostCommunication' | 'InitializationFailed' | 'TeardownFailed' | 'HaltFailed' | 'Failed' | 'Pending' | 'Distributed' | 'Initializing' | 'HaltDistributed' | 'InterruptTriggered' | 'RollbackTriggered' | 'RollbackStarted' | 'Running' | 'TearingDown' | 'Halt'
stageLifecycle'Active' | 'Halting' | 'Complete' | 'Error'

One of Active, Halting, Complete, or Error, this field describes where this execution is in its overall lifecycle. Values Complete and Error indicate the execution has finished.

owningTeamIdstring
runasUserstring
taskIdstring
kind'WebApp' | 'Api' | 'Scheduled' | 'Manual' | 'Spinnaker' | 'Concord' | 'GremlinFeeder' | 'GremlinSdkPython' | 'Scenario' | 'Chao' | 'K8sBackend' | 'Website' | 'Neotys' | 'IntegrationClient' | 'Validation'
argsstring[]
startTimestring date-time

The time at which this execution was created. For more fine-grained information about when exactly impact was applied, see client_states.

endTimestring date-time

The time at which this execution finished. For more fine-grained information about when exactly impact was removed, see client_states.

createdAtstring date-time
updatedAtstring date-time
metricsLinksobject