COconductorone
Connector Authoring Activation

Activate Revision

Changed on

ActivateRevision redeems a one-time approval token to activate a built connector revision onto its instance connector. It is OWNER-only. Double-activate protection is the single-use approval token itself: redeeming it is a compare-and-swap that rejects a second redemption of the same token. idempotency_key is optional and reserved for a future replay-result cache.

post/api/v1/connector-authoring/activations

Request

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

Request body

approvalTokenIdstring

The approvalTokenId field.

catalogIdstring

The catalogId field.

idempotencyKeystring

Optional, reserved for a future replay-result cache. It is accepted but currently unused: the single-use approval token is the double-activate mechanism, so no key is required today. Bounded so a future key stays sane.

instanceAppIdstring

The instanceAppId field.

instanceConnectorIdstring

The instanceConnectorId field.

revisionIdstring

The revisionId field.

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 revision; published only after cutover commits.

Changes