Skip to content
SYLVE

Bulk Delete Downloads

POST
/utilities/downloads/bulk-delete
curl --request POST \
  --url https://sylve.lan:8181/api/utilities/downloads/bulk-delete \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": [ 1 ] }'

Delete unique downloads after strict all-member preflight; missing, referenced, active, or unsafe members prevent all deletion, while unexpected cleanup failures return typed partial results

Authorizations

Section titled “Authorizations”

Request Body

Section titled “Request Body”

Bulk Delete Download Request

Media typeapplication/json
object
ids
required
Array<integer>
>= 1 items
Examplegenerated
{
  "ids": [
    1
  ]
}

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
object
data
object
deleted
Array<object>
object
id
integer
name
string
type
string
Allowed values: http torrent path
uuid
string
failed
Array<object>
object
code
string
id
integer
name
string
retainedPaths
Array<string>
type
string
Allowed values: http torrent path
uuid
string
vmReferences
Array<object>
object
storageId
integer
vmId
integer
vmName
string
vmRid
integer
error
string
message
string
status
string
Example
{
  "data": {
    "deleted": [
      {
        "type": "http"
      }
    ],
    "failed": [
      {
        "type": "http"
      }
    ]
  }
}

400

Section titled “400”

Bad Request

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

403

Section titled “403”

Forbidden

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

404

Section titled “404”

One or more downloads not found; nothing deleted

Media typeapplication/json
object
data
object
deleted
Array<object>
object
id
integer
name
string
type
string
Allowed values: http torrent path
uuid
string
failed
Array<object>
object
code
string
id
integer
name
string
retainedPaths
Array<string>
type
string
Allowed values: http torrent path
uuid
string
vmReferences
Array<object>
object
storageId
integer
vmId
integer
vmName
string
vmRid
integer
error
string
message
string
status
string
Example
{
  "data": {
    "deleted": [
      {
        "type": "http"
      }
    ],
    "failed": [
      {
        "type": "http"
      }
    ]
  }
}

409

Section titled “409”

One or more downloads active, referenced, or unsafe; nothing deleted

Media typeapplication/json
object
data
object
deleted
Array<object>
object
id
integer
name
string
type
string
Allowed values: http torrent path
uuid
string
failed
Array<object>
object
code
string
id
integer
name
string
retainedPaths
Array<string>
type
string
Allowed values: http torrent path
uuid
string
vmReferences
Array<object>
object
storageId
integer
vmId
integer
vmName
string
vmRid
integer
error
string
message
string
status
string
Example
{
  "data": {
    "deleted": [
      {
        "type": "http"
      }
    ],
    "failed": [
      {
        "type": "http"
      }
    ]
  }
}

413

Section titled “413”

Request body too large

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

500

Section titled “500”

Cleanup or persistence failure, possibly partial

Media typeapplication/json
object
data
object
deleted
Array<object>
object
id
integer
name
string
type
string
Allowed values: http torrent path
uuid
string
failed
Array<object>
object
code
string
id
integer
name
string
retainedPaths
Array<string>
type
string
Allowed values: http torrent path
uuid
string
vmReferences
Array<object>
object
storageId
integer
vmId
integer
vmName
string
vmRid
integer
error
string
message
string
status
string
Example
{
  "data": {
    "deleted": [
      {
        "type": "http"
      }
    ],
    "failed": [
      {
        "type": "http"
      }
    ]
  }
}