Skip to main content
ZStack
Infrastructure/Resource Deletion

ListSoftDeletedResources

List all soft-deleted resources with optional filters and pagination

GET/api/v1/deletion/soft-deleted

Operation ID

ListSoftDeletedResources

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Query Parameters

  • resourceType
    String

    Filter by resource type; empty means all types Filter by resource type; empty means all types

  • deletedAfter
    String

    Return only resources deleted after this timestamp Return only resources deleted after this timestamp

  • deletedBefore
    String

    Return only resources deleted before this timestamp Return only resources deleted before this timestamp

  • ownerType
    String

    Type of the owner to filter by Type of the owner to filter by

  • ownerUuid
    String

    UUID of the owner to filter by UUID of the owner to filter by

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    List of soft-deleted resources matching the query filters

    Example: (nested array)

    • resourceType
      String

      Type of the soft-deleted resource

      Example: VmInstance

    • resourceUuid
      String

      UUID of the soft-deleted resource

      Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

    • resourceName
      String

      Human-readable name of the soft-deleted resource

      Example: vm-web-01

    • deletionTimestamp
      String

      Timestamp when the resource was soft-deleted

      Example: 2026-01-15T08:00:00Z

    • retentionRemainingDays
      Integer

      Number of days remaining before permanent deletion

      Example: 7

  • total
    String

    Total number of soft-deleted resources matching the filters

    Example: 42