Delete Resource

This method deletes an S3 resource

info

A background task will be created upon successful request. You can track the task progress using the Tasks API

note

Resource deletion is not possible when VOD is enabled for any of its buckets. In this case, you must first disable and delete VOD for all associated buckets

Request Parameters

DELETE /api/clients/v1/s3Resources/{id}/

Headers

• Content-Type: application/json
• Authorization: Bearer $access_token

Path

Parameter	Type	Constraints	Description	Example
id	integer	> 0, required	Resource ID	16

Response Parameters

JSON body

Parameter	Type	Description
task_id	string	Task ID

Examples

200 OK

Task ID for resource deletion. The task result is contained in the task object

{
  "task_id": "bb4dcd80-01a5-4a73-8c2b-62c5027a9b72"
}

400 Bad Request

Invalid path parameters, or deletion is not possible due to existing related objects

{
  "id": [
    "A valid integer is required."
  ]
}

401 Unauthorized

Authentication credentials missing or invalid

{
  "detail": "Given token not valid for any token type",
  "code": "token_not_valid",
  "messages": [
    {
      "token_class": "AccessToken",
      "token_type": "access",
      "message": "Token is invalid or expired"
    }
  ]
}

403 Forbidden

Only project participants can delete resources associated with the project

{
  "detail": "Only project participants can view this project's resources"
}

404 Not Found

Resource with specified ID not found

{
  "detail": "Resource not found"
}