API Documentation

Appearance

DELETE /backtraces/ID ​

Description ​

Delete a backtrace specified by ID. The behavior of this call depends on the status of the backtrace:

  1. If the backtrace specified by ID is not yet done (i.e., in QUEUED or PROCESSING state), the backtrace is cancelled and no result will be produced.
  2. If the backtrace was already performed (i.e., in SUCCESS or FAILURE state), deleting the backtrace will delete all associated meta-data, including the backtrace result such as the traced tag (if successful).

Authentication ​

  • Required: Yes
  • Method: Bearer token

Headers ​

  • Authorization: Bearer [AUTH_TOKEN]
  • Accept:
    • application/json (for JSON responses)
    • application/xml (for XML responses)

Parameters ​

Query Parameters ​

  • format: string (Optional)
    Values: json, xml
    Overrides the Request Accept header.
  • human: boolean (Optional)
    Values: true, false
    Causes the response to be in a structured, more human-readable form.

Example Request ​

bash
curl -X DELETE "https://api.xvid.com/v1/backtraces/541db732e4b0eff926da9182?human=true" \
  -H "Authorization: Bearer AUTH_TOKEN" \
  -H "Content-Type: application/json"

Response ​

Success (200 OK) ​

json
{
  "result": {
    "status": "SUCCESS"
  }
}

Error Responses ​

400 Bad Request ​

json
{
  "error": {
    "error_code": "0050001",
    "error_message": "Invalid Input"
  }
}

403 Forbidden ​

json
{
  "error": {
    "error_code": "0x0000003",
    "error_message": "Invalid access token"
  }
}

404 Not Found ​

json
{
  "error": {
    "error_code": "0x0300007",
    "error_message": "Backtrace does not exist"
  }
}

500 Internal Server Error ​

json
{
  "error": {
    "error_code": "0x0000001",
    "error_message": "Internal Error"
  }
}