---
title: "Revoke an RCS message"
method: DELETE
path: "/{connect_customer_key}/agentMessages/{msisdn}/{messageId}"
tags: ["RCS Business Messaging"]
---

# Revoke an RCS message

`DELETE /{connect_customer_key}/agentMessages/{msisdn}/{messageId}`

## Request

- Base URL: `https://rbm.us.vibes.com/connectCustomers`
- URL: `https://rbm.us.vibes.com/connectCustomers/{connect_customer_key}/agentMessages/{msisdn}/{messageId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://vibes-rbm-prd.auth.us-west-2.amazoncognito.com/oauth2/token` scopes: `https://rbm.vibes.com/rbm.agents`

Revoke a message that has been sent to a mobile device, if the message has not already been delivered.

## Path parameters

- `connect_customer_key` string, required
- `msisdn` string, required
- `messageId` string, required

## Query parameters

- `agentId` string, required

## Response `200`

The request was successful. Note that this does <b>not</b> mean the message has been revoked. A webhook will be sent to the agent if the message was revoked.

## Other responses

- `403`: Forbidden agent. The `agentId` is either not valid, or it has not deployed on the provider.
- `422`: Unprocessable entity. Specific data errors have occurred in the request. Additional details will be available in the content of the error. <br><br> Example - Invalid Phone Number. The phone number is not a valid mobile number, or is on a unsupported carrier.
- `429`: Quota exceeded. You've either exceeded the number of calls allowed, or a downstream server is busy. Please try your request again later.

---

[API](https://skmtc.dev/vibes/apis/vibes-rcs-business-messaging-api.md) - [All operations](https://skmtc.dev/vibes/apis/vibes-rcs-business-messaging-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vibes/apis/vibes-rcs-business-messaging-api/revisions/94076f49389f?raw)