COconductorone
Connector Authoring Activation

Rollback Revision

Changed on

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

  • Base URL
    https://example.conductor.one
  • URL
    https://example.conductor.one/api/v1/connector-authoring/rollbacks
  • Auth
    HTTP bearer and OAuth 2
    Client credentials
    Token URL: /auth/v1/token

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

Committed activation epoch, or 0 when requested but not active yet.

deploymentEventIdstring

Non-empty while instance rotation is pending. Observe completion through GetInstallation.

revisionIdstring

The requested rollback target; published only after cutover commits.

Changes