marketplace

Revoke Installation Credential

Retires a superseded installation credential, so a partner can complete a rotation it started with POST /credentials/rotate — the leaked credential stops working without the customer having to reinstall. Authenticated by a live installation credential plus the integration's client secret. The credential to retire is named in the body rather than being the one that authenticates, so the ordinary flow is: rotate, store the replacement, then authenticate with the replacement and revoke the old one. Refuses to retire an installation's last live credential. Rotation exists so remediation is not customer-visible; revoking the only credential would undo that and leave the install needing a reinstall.

post/v1/installations/{integrationConfigurationId}/credentials/revoke

Path parameters

integrationConfigurationIdstring required

Request body

tokenstring required
client_secretstring required
client_idstring

Response

revokedfalse | true required
already_revokedfalse | true required

Changes