# Delete scheduled message

Delete a scheduled message.

You cannot delete a scheduled message which is already being sent or is already sent.

# Method

DELETE

/messages/scheduled/[message_id]

Name	Value	Required?
message_id	ID of the scheduled message.	Yes

Code	Remarks
200	Request was successful.
400	Validation error or request body was incorrectly formatted.
401	Authentication failed. Check `apikey` header.
404	Requested API endpoint not found.
429	The rate limit has been reached.
500-511	There was a problem processing the request on our server. Try again later.

Name	Value	Remarks
status	`success` or `error`	-
errors	Array of object `{ msg: [error detail] }`	Only present when status is `error`.

curl --location --request DELETE 'https://api.sociocs.com/messages/scheduled/Xyz12345' \
--header 'apikey: your_api_key'