Create a Review
Supply exactly one source: draft with change_set_id, or promotion with source_team_id, target_team_id and selected resource_keys. Drafts use their saved versions and can be reviewed with approval-to-publish off; retries return the saved review. For a promotion, include top-level request_id. To revise a promotion, set promotion.revision with review_id and the latest expected_revision_id; omit expected_revision_id only if no revision exists. Title and description apply only to new reviews. Exact retries reuse the saved selection; a changed expected revision captures the selection again. RETRY_REQUIRED means the review was saved but setup needs recovery. NOT_NEEDED means no setup remains for that saved submission. This endpoint never publishes or applies changes.
Authentication and permissions
Token requirements: User-based token (OAuth). Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
- User: staged Catalyst draft: With draft.change_set_id, requires workspace session access and permission to view the originating Catalyst chat or agent session in your organization. Creates a review of the staged versions, including when approval-to-publish is off. Omit promotion and revision inputs. Retrying the same change set returns its review. This operation never publishes or applies changes.
- User: create or revise promotion review: Requires author permission on the source and stage permission on the target, including retries. Retries are bound to the submitting user and workspace pair. New revisions require review revisions to be enabled, visibility of the existing review, the same workspace pair, and its current revision ID. Existing branch, link, validation, and receiving-approval checks remain enforced. This operation does not apply changes.
Authorizations
Body
- CreateReviewRequest
- CreateReviewRequest

