Allows for a listing to be immediately deleted or to be scheduled for deletion.All date fields included in the body parameters need to be specified as ISO8601-formatted date strings.Date fields should follow a “YYYY-MM-DD” format.
Listed below are common errors that may be returned by the endpoint, along with their corresponding status code.Status Code - 400
Missing Authorization header
Copy
Ask AI
{ "error": { "type": "missing_authorization", "message": "Your request does not include an 'Authorization' header with a bearer token for your account." }}
Status Code - 401
Expired Authorization header bearer token value
Copy
Ask AI
{ "error": { "type": "expired_token", "message": "The bearer token you have provided in the 'Authorization' header has expired. Please obtain a new one." }}
Status Code - 401
Invalid Authorization header bearer token value
Copy
Ask AI
{ "error": { "type": "invalid_authorization", "message": "The bearer token you have provided in the 'Authorization' header is invalid." }}
Status Code - 401Returned if the currently authenticated user does not have permission to delete the listing they are attempting to delete
Invalid/Expired Authorization header bearer token value
Copy
Ask AI
{ "error": { "type": "not_authorized", "message": "The user you have authenticated as is not authorized to delete the listing you are attempting to delete." }}