---
title: "revokeMessage(_:)"
framework: TelephonyMessagingKit
role: symbol
role_heading: Instance Method
platforms: [iOS 26.0+]
path: "telephonymessagingkit/rcsservice/revokemessage(_:)"
---

# revokeMessage(_:)

Requests revocation of an RCS message.

## Declaration

```swift
final func revokeMessage(_ request: RCSService.RevokeMessageRequest) async throws -> Bool
```

## Parameters

- `request`: The request that contains the message to be revoked.

## Return Value

Return Value A Boolean value that indicates whether sending the request to the carrier network succeeded.

## Discussion

Discussion The RCS specification requires that you revoke a message when delivery fails or times out, and fall back to sending the message with SMS or MMS. note: If the session is no longer valid, this method throws TelephonyMessagingSession.Error.invalidSession. If the method can’t resolve the handle in the request, it throws RCSService.Error.invalidArgument. If the method can’t process the revoke request for other reasons it throws RCSService.Error.internalError.

## See Also

### Revoking messages

- [RCSService.RevokeMessageRequest](telephonymessagingkit/rcsservice/revokemessagerequest.md)