# List Bulk Actions

> List the bulk actions created by filter-based workflow run cancels

`GET /v2/workflows/bulkActions`

A bulk action is created for every filter-based [bulk cancel](/workflow/api-reference/runs/bulk-cancel-workflow-runs) request, and tracks the progress of the cancellation running in the background.

Bulk actions are kept for 7 days after they are created.

<Note>
The `state` filter is applied to each page separately. A page may contain fewer than `count` bulk actions, or none at all, even when there are more to list. Keep paginating until no `cursor` is returned.
</Note>

## OpenAPI

````yaml workflow/openapi.yaml get /v2/workflows/bulkActions
openapi: 3.1.0
info:
  title: Upstash Workflow REST API
  description: >
    Upstash Workflow is a serverless workflow orchestration service built on top
    of Upstash QStash and Upstash Redis.
  version: 2.0.0
  contact:
    name: Upstash
    url: https://upstash.com
servers:
  - url: https://qstash-{region}.upstash.io
    description: Regional
    variables:
      region:
        default: eu-central-1
        enum:
          - us-east-1
          - eu-central-1
security:
  - bearerAuth: []
  - bearerAuthQuery: []
paths:
  /v2/workflows/bulkActions:
    get:
      summary: List Bulk Actions
      description: List the bulk actions created by filter-based workflow run cancels
      tags:
        - Bulk Actions
      x-mint:
        content: >
          A bulk action is created for every filter-based [bulk
          cancel](/workflow/api-reference/runs/bulk-cancel-workflow-runs)
          request, and tracks the progress of the cancellation running in the
          background.


          Bulk actions are kept for 7 days after they are created.


          <Note>

          The `state` filter is applied to each page separately. A page may
          contain fewer than `count` bulk actions, or none at all, even when
          there are more to list. Keep paginating until no `cursor` is returned.

          </Note>
      parameters:
        - in: query
          name: cursor
          required: false
          schema:
            type: string
          description: By providing a cursor you can paginate through all of the bulk
            actions.
        - in: query
          name: count
          required: false
          schema:
            type: integer
            minimum: 1
            default: 100
            maximum: 1000
          description: The number of bulk actions to scan per page. Values above 1000 are
            treated as 1000.
        - in: query
          name: state
          required: false
          schema:
            type: string
            enum:
              - IN_PROGRESS
              - FINISHED
          description: Filter bulk actions by state.
      responses:
        "200":
          description: List of bulk actions
          content:
            application/json:
              schema:
                type: object
                properties:
                  bulkActions:
                    type: array
                    items:
                      $ref: "#/components/schemas/BulkAction"
                  cursor:
                    type: string
                    description: >
                      A cursor which you can use in subsequent requests to
                      paginate through all bulk actions.

                      If no cursor is returned, you have reached the end of the
                      bulk actions.
        "400":
          description: Invalid `count`, `cursor` or `state`
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: QStash authentication token
    bearerAuthQuery:
      type: apiKey
      in: query
      name: qstash_token
      description: QStash authentication token passed as a query parameter
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Error message
    BulkAction:
      type: object
      properties:
        actionId:
          type: string
          description: The ID of the bulk action.
        kind:
          type: string
          enum:
            - cancel
          description: The kind of the bulk action.
        state:
          type: string
          enum:
            - IN_PROGRESS
            - FINISHED
          description: |
            The state of the bulk action.

            |Value	|Description|
            |-------|------------|
            | IN_PROGRESS	|The bulk action is running in the background.|
            | FINISHED	|The bulk action has finished.|
        total:
          type: integer
          format: int64
          description: The number of in-progress workflow runs that matched the filter
            when the bulk action was created.
        processed:
          type: integer
          format: int64
          description: The number of workflow runs processed by the bulk action so far.
        createdAt:
          type: integer
          format: int64
          description: The creation time of the bulk action, in milliseconds (Unix
            timestamp).
        completedAt:
          type: integer
          format: int64
          description: The completion time of the bulk action, in milliseconds (Unix
            timestamp). Only present once the bulk action has finished.
        filter:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >
            The filter the bulk action was created with. Keys are the filter
            parameter names of the bulk cancel request, such as `workflowUrl`,
            `label` or `fromDate`, and values are the given values.
          example:
            workflowUrl:
              - https://example.com/api/workflow
            label:
              - label_1
              - label_2
````