Delete destination

Removes the destination and its stored credentials. Media already delivered to your bucket stays where it is; tasks still naming this destination start failing delivery.

DELETE/destinations/{id}

AuthAPI keyorOAuth tokenHow to send it

Path parameters

idstringrequired: The destination to delete.
e.g. "dst_01KE7XWWEQ4MCGWKBQKJ1G47RP"

Response

Destination deleted

No body.

Errors

A failed call names what went wrong in code, with a sentence in message. The codes, which of them are worth retrying, and how to read a validation failure are on Errors.

Request

curl -X DELETE https://api.mynth.io/destinations/dst_01KE7XWWEQ4MCGWKBQKJ1G47RP \
  -H "Authorization: Bearer $MYNTH_API_KEY"

Response

{
  "error": {
    "code": "validation_error",
    "message": "count: Too big: expected number to be <=20. colour: Unknown field.",
    "issues": [
      {
        "path": [
          "count"
        ],
        "message": "Too big: expected number to be <=20"
      },
      {
        "path": [
          "colour"
        ],
        "message": "Unknown field."
      }
    ]
  }
}