---
schema_version: "1"
id: af33d8790f5e1b589fcfc3b35751dc9234ef6be16dcd499165e20480556ec593
title: DELETE /messaging/v1/sms/definitions/{definitionKey}/queue
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/deleteSMSQueuedMessagesForDefinition.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_transactional_messaging_sms/deleteSMSQueuedMessagesForDefinition.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4b7af771f396b39eff8add90a51b8074e8308df4fe6d0fa76d3ee3e99b125824
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# DELETE /messaging/v1/sms/definitions/{definitionKey}/queue

Deletes the queue for a send definition. The send definition must be inactive.

## URL Parameters

| Name              | Type   | Description                                    |
| ----------------- | ------ | ---------------------------------------------- |
| **definitionKey** | string | Required. Unique identifier of the definition. |

## Usage

In your DELETE request, include the definition key in the URL path.

```
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
DELETE /messaging/v1/sms/definitions/DEFINITION_KEY/queue
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
```

If the request is successful, the API returns a request ID and the status of the request.

```js
HTTP/1.1 200 OK
{
  "requestId":"bf27b84b-72e8-4244-8bdb-93e5de5fc7d8",
  "message":"Queued"
}
```