SUsumup
Roles

Delete a role

Changed on

Delete a custom role.

delete/v0.1/merchants/{merchant_code}/roles/{role_id}

Request

  • Base URL
    https://api.sumup.com
  • URL
    https://api.sumup.com/v0.1/merchants/{merchant_code}/roles/{role_id}
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://api.sumup.com/authorize
      Token URL: https://api.sumup.com/token scopes: user.subaccounts, roles.write

Path parameters

merchant_codestring required
Example:MK10CL2A

Short unique identifier for the merchant.

role_idstring required
Example:role_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP

The ID of the role to retrieve.

Response

Returns an empty response if the role deletion succeeded.

Changes

  • c75ca16e1e44Revision changes
    • info

      the security scope roles.write was added to the endpoint's security scheme oauth2

    • info

      the security scope user.subaccounts was added to the endpoint's security scheme oauth2

  • cd79d83b07e0Revision changes
    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status