---
title: "Cancel sms messages"
method: POST
path: "/v4/sms/outgoing/cancel"
tags: ["Sms - Outgoing"]
---

# Cancel sms messages

`POST /v4/sms/outgoing/cancel`

## Request

- Base URL: `https://api.inmobile.com`
- URL: `https://api.inmobile.com/v4/sms/outgoing/cancel`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `apikey`

## Request body

- SmsOutgoingCancelPostRequest
  - `messageIds` string[], required: A list of the sms message ids to be cancelled. Allowed to contain between 1 and 250 elements.

## Response `200`

- SmsOutgoingCancelPostReply
  - `results` SmsOutgoingCancelPostReplyResultModel[]: A list of results
    - `messageId` string: The MessageId of the message that was attempted cancelled.
    - `resultCode` 0 | 1 | -2 | -1: 0 = Unknown 1 = Success -2 = MessageNotFound -1 = NotCancelled
    - `resultDescription` string: A description of the result.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/inmobile/apis/inmobile-rest-api.md) · [All operations](https://skmtc.dev/inmobile/apis/inmobile-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inmobile/apis/inmobile-rest-api/revisions/197a90ad5f8f?raw)
