---
title: "Rollback Revision"
method: POST
path: "/api/v1/connector-authoring/rollbacks"
tags: ["Connector Authoring Activation"]
---

# Rollback Revision

`POST /api/v1/connector-authoring/rollbacks`

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.

## Request body

- C1ApiConnectorAuthoringV1ConnectorAuthoringServiceRollbackRevisionRequest — The ConnectorAuthoringServiceRollbackRevisionRequest message.
  - `approvalTokenId` string — The approvalTokenId field.
  - `catalogId` string — The catalogId field.
  - `instanceAppId` string — The instanceAppId field.
  - `instanceConnectorId` string — The instanceConnectorId field.
  - `reason` string — Optional operator justification, recorded on the audit event.
  - `targetRevisionId` string — 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 `200`

Successful response

- C1ApiConnectorAuthoringV1ConnectorAuthoringServiceRollbackRevisionResponse — The ConnectorAuthoringServiceRollbackRevisionResponse message.
  - `activationEpoch` string, uint64 — The activationEpoch field.
  - `revisionId` string — The revision now published (the rollback target).

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)