# CancelPermissions API Operation (/api/nvp-soap/cancel-permissions)



> **Note:** **Important:** The Adaptive Platform API is not available for new integrations. PayPal provides this documentation to support existing integrations. If you're starting an integration, [we recommend our latest solutions](/).

Cancels access to a set of permissions.

## CancelPermissionsRequest Message [#cancelpermissionsrequest-message]

![](https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/CancelPermissionsRequest.gif)

### CancelPermissionsRequest Fields [#cancelpermissionsrequest-fields]

| Field<br />             | Description<br />                                                                                                                                                 |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `token`<br />           | `xs:string`<br /&#x3E; &#x2A;(Required)* The access token that identifies a set of permissions to cancel.<br />                                                   |
| `requestEnvelope`<br /> | `common:requestEnvelope`<br /&#x3E; &#x2A;(Required)* Information common to each API operation, such as the language in which an error message is returned.<br /> |

### RequestEnvelope Fields [#requestenvelope-fields]

| Field<br />           | Description<br />                                                                                                                                                                                                             |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `detailLevel`<br />   | `common:DetailLevelCode`<br /&#x3E; &#x2A;(Optional)* Level of detail required by the client application for components. Value is:<br /> <br />`ReturnAll` — This value provides the maximum level of detail (default).<br /> |
| `errorLanguage`<br /> | `xs:string`<br /&#x3E; &#x2A;(Required)* RFC 3066 language in which error messages are returned; by default it is `en_US`, which is the only language currently supported.<br />                                              |

## CancelPermissionsResponse Message [#cancelpermissionsresponse-message]

![](https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/CancelPermissionsResponse.gif)

### CancelPermissions Response Fields [#cancelpermissions-response-fields]

| Field<br />              | Description<br />                                                                                                                |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `responseEnvelope`<br /> | `common:ResponseEnvelope`<br /> Common response information, including a timestamp and the response acknowledgment status.<br /> |

### ResponseEnvelope Fields [#responseenvelope-fields]

| Field<br />           | Description<br />                                                                                                                                                                                                                                                                                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ack`<br />           | `common:AckCode`<br /> Acknowledgment code. Value is:<br /> <br />`Success` — The operation completed successfully.<br />`Failure` — The operation failed.<br />`Warning` — Warning.<br />`SuccessWithWarning` — The operation completed successfully; however, there is a warning message.<br />`FailureWithWarning `— The operation failed with a warning message.<br /> |
| `build`<br />         | Build number; it is used only by Merchant Technical Support.<br />                                                                                                                                                                                                                                                                                                         |
| `correlationId`<br /> | Correlation ID; it is used only by Merchant Technical Support.<br />  > **Note:** &#x2A;*Note:** You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.                                                                                                                            |
| `timestamp`<br />     | Date on which the response was sent. The time is currently not supported.<br />  > **Note:** &#x2A;*Note:** You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.                                                                                                                 |

## PPFault Message [#ppfault-message]

The `PPFaultMessage` returns `ErrorData` and the `ResponseEnvelope` information to your application if an error occurs.

![](https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/FaultMessage.gif)

![](https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/ErrorData.gif)

### FaultMessage Fields [#faultmessage-fields]

| Field<br />              | Description<br />                                                                                                                |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `error`<br />            | `common:ErrorData`<br /> Detailed error information.<br />                                                                       |
| `responseEnvelope`<br /> | `common:ResponseEnvelope`<br /> Common response information, including a timestamp and the response acknowledgment status.<br /> |

### ErrorData Fields [#errordata-fields]

| Field<br />         | Description<br />                                                                                                                                                                                                                                                       |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `category`<br />    | `common:ErrorCategory`<br /> The location where the error occurred.<br /> Value is:<br /> <br />`System` — The system encountered errors; try again<br />`Application` — The application encountered errors; try again<br />`Request` — The request was incorrect<br /> |
| `domain`<br />      | The domain to which this service belongs.<br />                                                                                                                                                                                                                         |
| `errorId`<br />     | A number that uniquely identifies a particular error.<br />                                                                                                                                                                                                             |
| `exceptionID`<br /> | This field is not used.<br />                                                                                                                                                                                                                                           |
| `message`<br />     | A description of the error.<br />                                                                                                                                                                                                                                       |
| `parameter`<br />   | `common:ErrorParameter`<br /> Represents contextual information about the error.<br />                                                                                                                                                                                  |
| `severity`<br />    | `common:ErrorSeverity`<br /> The severity of the error encountered.<br /> Value is:<br /> <br />`Error` — Processing of the request was interrupted<br />`Warning` — Processing of the request was completed<br />                                                      |
| `subdomain`<br />   | This field is not used.<br />                                                                                                                                                                                                                                           |

### ResponseEnvelope Fields [#responseenvelope-fields-1]

| Field<br />           | Description<br />                                                                                                                                                                                                                                                                                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ack`<br />           | `common:AckCode`<br /> Acknowledgment code. Value is:<br /> <br />`Success` — The operation completed successfully.<br />`Failure` — The operation failed.<br />`Warning` — Warning.<br />`SuccessWithWarning` — The operation completed successfully; however, there is a warning message.<br />`FailureWithWarning `— The operation failed with a warning message.<br /> |
| `build`<br />         | Build number; it is used only by Merchant Technical Support.<br />                                                                                                                                                                                                                                                                                                         |
| `correlationId`<br /> | Correlation ID; it is used only by Merchant Technical Support.<br />  > **Note:** &#x2A;*Note:** You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.                                                                                                                            |
| `timestamp`<br />     | Date on which the response was sent. The time is currently not supported.<br />  > **Note:** &#x2A;*Note:** You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.                                                                                                                 |

## CancelPermissions Errors [#cancelpermissions-errors]

| Code<br />   | Message<br />              | Additional Information<br /> |
| ------------ | -------------------------- | ---------------------------- |
| 580022<br /> | Invalid Access Token<br /> |                              |