Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-216381,9552.9 MB

f2cf3228f366

Connector Authoring Activation

Rollback Revision

RollbackRevision redeems a one-time approval token (bound to the rollback target's integrity root) to re-point the published + instance pointers at a previously activated, still-servable revision under a strictly greater activation epoch. It is OWNER-only. The rolled-back-FROM revision's serve state is untouched — the pointer move alone stops it serving; permanently ending a revision's serve eligibility is a platform kill-switch operation, not a tenant API verb.

post/api/v1/connector-authoring/rollbacks

Request body

approvalTokenIdstring

The approvalTokenId field.

catalogIdstring

The catalogId field.

instanceAppIdstring

The instanceAppId field.

instanceConnectorIdstring

The instanceConnectorId field.

reasonstring

Optional operator justification, recorded on the audit event.

targetRevisionIdstring

The previously activated revision the published + instance pointers roll back TO. Caller-chosen and explicit so the audit trail records an exact, human-selected target.

Response

Successful response

activationEpochstring uint64

The activationEpoch field.

revisionIdstring

The revision now published (the rollback target).