> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-ia-reframe-draft.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/connector-authoring/rollbacks
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/connector-authoring/rollbacks:
    post:
      tags:
        - Connector Authoring Activation
      summary: Rollback Revision
      description: >-
        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.
      operationId: >-
        c1.api.connector_authoring.v1.ConnectorAuthoringActivationService.RollbackRevision
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.connector_authoring.v1.ConnectorAuthoringServiceRollbackRevisionRequest
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.connector_authoring.v1.ConnectorAuthoringServiceRollbackRevisionResponse
          description: Successful response
      x-codeSamples:
        - lang: go
          label: RollbackRevision
          source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := conductoronesdkgo.New(\n        conductoronesdkgo.WithSecurity(shared.Security{\n            BearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n            Oauth: \"<YOUR_OAUTH_HERE>\",\n        }),\n    )\n\n    res, err := s.ConnectorAuthoringActivation.RollbackRevision(ctx, nil)\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.ConnectorAuthoringServiceRollbackRevisionResponse != nil {\n        // handle response\n    }\n}"
components:
  schemas:
    c1.api.connector_authoring.v1.ConnectorAuthoringServiceRollbackRevisionRequest:
      description: The ConnectorAuthoringServiceRollbackRevisionRequest message.
      properties:
        approvalTokenId:
          description: The approvalTokenId field.
          type: string
        catalogId:
          description: The catalogId field.
          type: string
        instanceAppId:
          description: The instanceAppId field.
          type: string
        instanceConnectorId:
          description: The instanceConnectorId field.
          type: string
        reason:
          description: Optional operator justification, recorded on the audit event.
          type: string
        targetRevisionId:
          description: >-
            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.
          type: string
      title: Connector Authoring Service Rollback Revision Request
      type: object
      x-speakeasy-name-override: ConnectorAuthoringServiceRollbackRevisionRequest
    c1.api.connector_authoring.v1.ConnectorAuthoringServiceRollbackRevisionResponse:
      description: The ConnectorAuthoringServiceRollbackRevisionResponse message.
      properties:
        activationEpoch:
          description: The activationEpoch field.
          format: uint64
          type: string
        revisionId:
          description: The revision now published (the rollback target).
          type: string
      title: Connector Authoring Service Rollback Revision Response
      type: object
      x-speakeasy-name-override: ConnectorAuthoringServiceRollbackRevisionResponse
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````