---
title: "List Purges"
method: GET
path: "/delivery/v2.1/global/workspaces/{workspaceUUID}/purges"
tags: ["CDN and DNS (v2.1)"]
---

# List Purges

`GET /delivery/v2.1/global/workspaces/{workspaceUUID}/purges`

Retrieves a paginated list of all Purge objects in the specified workspace.
The response includes details about each Purge such as its configuration,
status, and metadata. Results can be filtered using query parameters.

## Path parameters

- `workspaceUUID` string, required

## Response `200`

Successfully retrieved the list of Purge objects. The response includes
Purge information like name, creation time, and status.

- V2PurgeList
  - `apiVersion` 'delivery/v2' | 'delivery/v2.1', required — Version identifier of the API schema
  - `items` V2Purge[], required — List of Purge resources
    - `apiVersion` 'delivery/v2' | 'delivery/v2.1', required — Version identifier of the API schema
    - `kind` 'Purge', required — The string value 'Purge' that identifies the schema
    - `metadata` V2ObjectMeta, required — Standard resource metadata fields
      - `creationTimestamp` string, date-time, required
      - `labels` object, required — Labels are key-value pairs attached to resources for organization and categorization
      - `name` string, required — User-provided name that uniquely identifies the resource within its workspace
      - `namespace` string, required — Namespace is the namespace in which the resource exists
      - `uid` string, required — System-generated unique identifier for the resource
    - `spec` V1beta1PurgeSpec, required — Desired configuration for the Purge
      - `hostname` string, required — The domain name for which the CDN is created.
      - `paths` string[], required — The absolute or prefix paths to purge. Paths ending with * are treated as prefix paths. Limited to 20k specific paths and 1k prefix paths across all purges within a namespace.
      - `subdomains` string[] — The subdomains of the CDN to purge.
    - `status` V1beta1PurgeStatus, required — Current observed state of the Purge
      - `appliedCDNs` string[]
      - `status` string, required
  - `kind` 'PurgeList', required — The string value 'PurgeList' that identifies the schema
  - `metadata` V1ListMeta, required — Standard resource metadata fields
    - `continue` string
    - `remainingItemCount` integer, nullable
    - `resourceVersion` string
    - `selfLink` string

## Other responses

- `400` — Bad Request - invalid request payload or parameters
- `401` — Unauthorized - invalid or expired authentication token
- `403` — Forbidden - insufficient permissions

---

[API](https://skmtc.dev/sotoon/apis/sotoon-api.md) · [All operations](https://skmtc.dev/sotoon/apis/sotoon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sotoon/sotoon-api/revisions/c937cd9861c5/schema)