---
title: "Return a page of active ad-hoc experiments."
method: GET
path: "/attacks/active/paged"
tags: ["attacks"]
---

# Return a page of active ad-hoc experiments.

`GET /attacks/active/paged`

This endpoint will return a paged response of active ad-hoc experiments for a team.
Requires the privilege [`EXPERIMENTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `pageSize` integer
- `pageToken` string
- `teamId` string, required

## Response `default`

default response

- PagedResponseExperimentsResponse
  - `pageNumber` integer
  - `pageSize` integer — The size of the page requested. If none was supplied this is a default value (depending on the endpoint). If the length of items is less than this number that means there are _no_ more pages to request. NOTE: if the length *is* equal there may or may not be additional pages to request, it is unknowable until they are requested
  - `pageToken` string — Supply this token on successive requests to retrieve the next page if there is one
  - `items` ExperimentsResponse[]
    - `orgId` string
    - `guid` string
    - `args` string[]
    - `stage` 'InvalidArgument' | 'TargetNotFound' | 'Successful' | 'UserHalted' | 'ClientAborted' | 'LostCommunication' | 'InitializationFailed' | 'TeardownFailed' | 'HaltFailed' | 'Failed' | 'Pending' | 'Distributed' | 'Initializing' | 'HaltDistributed' | 'InterruptTriggered' | 'RollbackTriggered' | 'RollbackStarted' | 'Running' | 'TearingDown' | 'Halt'
    - `createSource` 'WebApp' | 'Api' | 'Scheduled' | 'Manual' | 'Spinnaker' | 'Concord' | 'GremlinFeeder' | 'GremlinSdkPython' | 'Scenario' | 'Chao' | 'K8sBackend' | 'Website' | 'Neotys' | 'IntegrationClient' | 'Validation'
    - `triggerSource` 'MANUAL' | 'RUN_ALL' | 'SCHEDULED' | 'RECURRING_SCHEDULE'
    - `kind` 'WebApp' | 'Api' | 'Scheduled' | 'Manual' | 'Spinnaker' | 'Concord' | 'GremlinFeeder' | 'GremlinSdkPython' | 'Scenario' | 'Chao' | 'K8sBackend' | 'Website' | 'Neotys' | 'IntegrationClient' | 'Validation'
    - `owningTeamId` string
    - `createSourceDetail` 'Onboarding'
    - `infraTarget` object
    - `infraCommand` object
    - `targets` string[]
    - `targetContainers` object
    - `stageLifecycle` 'Active' | 'Halting' | 'Complete' | 'Error'
    - `createUser` string
    - `executionSummaries` object
    - `executionStageSummary` object
    - `tags` object
    - `multiSelectTags` object
    - `labels` object
    - `multiSelectLabels` object
    - `targetType` 'Host' | 'Container' | 'Docker' | 'Kubernetes'
    - `attackConfiguration` AttackConfiguration
      - `command` ServiceCommand, required
        - `infraCommandType` 'CPU' | 'IO' | 'Memory' | 'Disk' | 'Thread_Bomb' | 'Blackhole' | 'DNS' | 'Latency' | 'Packet_Loss' | 'Collect_Certs' | 'Shutdown' | 'Time_Travel' | 'Process_Killer' | 'Process_Exhaustion' | 'GPU' | 'Unknown'
        - `infraCommandArgs` InfraCommandArgs
          - `type` 'CPU' | 'IO' | 'Memory' | 'Disk' | 'Thread_Bomb' | 'Blackhole' | 'DNS' | 'Latency' | 'Packet_Loss' | 'Collect_Certs' | 'Shutdown' | 'Time_Travel' | 'Process_Killer' | 'Process_Exhaustion' | 'GPU' | 'Unknown'
          - `unknownArgs` object
          - `duplicateArgs` object[]
          - `cliArgs` string[]
          - `lengthOrZero` integer
      - `targets` ServiceTarget[], required
        - `serviceId` string
        - `targetingStrategy` TargetingStrategy, required
          - `type` string, required
      - `sampling` TargetSampling
        - `type` string, required
    - `startTime` string, date-time
    - `endTime` string, date-time
    - `initializationEndTime` string, date-time
    - `commandTemplateId` string
    - `targetTemplateId` string
    - `scenarioId` string
    - `scenarioRunNumber` integer
    - `scenarioStepNumber` integer
    - `scenarioNodeGuid` string
    - `serviceId` string
    - `k8sAttackId` string
    - `k8sObjectResponse` AttackK8sObjectResponse
      - `impactDefinition` Command
        - `providers` string[]
        - `args` string[]
        - `trafficImpactMapping` TaskTrafficImpactMappingInput
          - `multiSelectTags` object
          - `dependencyIds` string[]
        - `trafficImpactFromWithSelectTags` object
        - `trafficImpactWithDependencyIds` string[]
        - `type` string
        - `templateId` string
        - `optionalTemplateId` string
        - `empty` boolean
      - `targetDefinition` TargetK8sObjectResponse
        - `strategy` StrategyK8sObjectResponse
          - `k8sObjects` K8sObjectResponse[]
            - `clusterId` string
            - `ownerReferences` string
            - `createdAt` string, date-time
            - `resolvedContainers` string[]
            - `uid` string
            - `namespace` string
            - `name` string
            - `kind` 'DEPLOYMENT' | 'REPLICASET' | 'POD' | 'DAEMONSET' | 'STATEFULSET' | 'SERVICE' | 'INGRESS' | 'DEPLOYMENTCONFIG' | 'REPLICATIONCONTROLLER' | 'ROLLOUT' | 'HORIZONTALPODAUTOSCALER' | 'PODDISRUPTIONBUDGET'
            - `labels` object
            - `annotations` object
            - `podPhase` 'Pending' | 'Running' | 'Succeeded' | 'Failed' | 'Unknown'
            - `hostId` string
            - `availableContainers` K8sContainerResponse[]
              - …
            - `targetType` 'Host' | 'Container' | 'Docker' | 'Kubernetes'
          - `containerSelection` ContainerSelection
            - `selectionType` 'EXACT' | 'ALL' | 'ANY'
            - `containerNames` string[]
          - `k8sObjectsInternal` K8sObjectOnAttack[]
            - `clusterId` string
            - `uid` string
            - `namespace` string
            - `name` string
            - `kind` 'DEPLOYMENT' | 'REPLICASET' | 'POD' | 'DAEMONSET' | 'STATEFULSET' | 'SERVICE' | 'INGRESS' | 'DEPLOYMENTCONFIG' | 'REPLICATIONCONTROLLER' | 'ROLLOUT' | 'HORIZONTALPODAUTOSCALER' | 'PODDISRUPTIONBUDGET'
            - `labels` object
            - `annotations` object
            - `ownerReferences` string
            - `createdAt` string, date-time
            - `resolvedContainers` string[]
            - `data` string
            - `clientId` string
            - `teamId` string
            - `resolved` boolean
            - `attackUid` string
          - `count` integer
          - `percentage` integer
      - `includeNewTargets` boolean
      - `continueOnEmptyTargets` boolean
    - `k8sStage` 'RESOLVING' | 'ERROR' | 'LAUNCHED' | 'USER_HALTED'
    - `k8sAttackCreatedAt` string, date-time
    - `k8sAttackUpdatedAt` string, date-time
    - `k8sError` string
    - `annotations` object
    - `totalClients` integer
    - `clientMetricsEnabledCount` integer
    - `providers` string[]
    - `trafficImpactMapping` TrafficImpactMapping
      - `multiSelectTags` object
      - `dependencyIds` string[]
    - `includeNewClients` boolean
    - `dynamicallyResolvedIps` string[]
    - `displayErrorMessage` string
    - `executionFailureReasons` ExecutionFailureReasons
      - `executionIdToReason` object
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: EXPERIMENTS_READ

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/36ee938323f0/schema)