Practice Review Settings

Update the workspace's practice-review policy

Changed on
patch/workspaces/{workspaceSlug}/practices/review-settings

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /workspaces/{workspaceSlug}/practices/review-settings
  • Auth: HTTP bearer

Path parameters

workspaceSlugstring required

Workspace slug

Headers

If-Matchstring

Request body

cooldownMinutesinteger

Minimum minutes between reviews for the same PR; 0 disables the cooldown

defaultAutonomy'OFF' | 'HUMAN_APPROVAL' | 'AUTOMATIC'

How much autonomy the system has over practices and groups that hold no autonomy of their own. The one decision that moves a whole workspace at once. Null leaves it unchanged; name DEFAULT_AUTONOMY in 'reset' to clear it.

deliverToMergedboolean

Deliver feedback to already-merged PRs/MRs

deliveryStatus'ACTIVE' | 'PAUSED'

Pause or activate external feedback. Resume never releases work from an older revision.

generatedPathsobject

Patch generated-path patterns per monitored repository. An empty list clears that repository. Null leaves all unchanged.

resetstring[]

Fields to reset back to inherit

Response

Policy updated

cooldownMinutesinteger required

Effective: minimum minutes between reviews for the same PR

cooldownMinutesOverrideinteger

Raw override; null = inheriting the fleet default

defaultAutonomy'OFF' | 'HUMAN_APPROVAL' | 'AUTOMATIC' required

Effective: how much autonomy the system has over practices and groups that hold no autonomy of their own — the bottom of the practice → group → workspace chain

defaultAutonomyOverride'OFF' | 'HUMAN_APPROVAL' | 'AUTOMATIC'

Raw override; null = this workspace has never chosen, so HUMAN_APPROVAL applies

deliverToMergedboolean required

Effective: deliver feedback to merged PRs/MRs

deliverToMergedOverrideboolean

Raw override; null = inheriting the fleet default

deliveryStatus'ACTIVE' | 'PAUSED' required

Whether new external practice feedback may be sent

etagstring required

Strong entity tag to send in If-Match when updating this rollout

generatedPathsobject required

Repository-root Ant-style generated-path patterns, keyed by monitored repository name

revisioninteger required

Monotonic rollout revision carried by automatically admitted review jobs

Changes

  • 9662502b2cc4Revision changes
    • breaking

      for the path request parameter workspaceSlug, the minLength was increased from 0 to 3

    • warning

      for the path request parameter workspaceSlug, the maxLength was set to 51

    • warning

      changed the pattern of the path request parameter workspaceSlug from ^[a-z0-9][a-z0-9-]{2,50}$ to ^(?!.*--)[a-z0-9][a-z0-9-]{1,49}[a-z0-9]$

  • 776fba97d0b5Revision changes
    • info

      added the new optional request property

    • info

      added the required property to the response with the status