API Reference
Log In
API Reference

Update Team PR Health Settings

Update the PR Health settings for a team. agingDays and rottingDays are required and agingDays must be lower than rottingDays. Every other field is optional and absent or null leaves it unchanged; cutoffDateIsDefault=true restores the default (full-history counts, dollars from the first coding-assistant day) and ignores any cutoffDate beside it; an empty excludedRepos or automationPatterns list clears it. A cutoffDate in the future or before 2008-01-01, more than 200 repositories or one not shaped owner/repo, more than 20 patterns, and a pattern that is blank, longer than 200 characters, invalid in Java or PostgreSQL (alone or combined with the others), or matching an empty string, are all a 400.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique identifier of the team. Format: Revenium hashid (URL-safe encoded string).

Body Params

Team-level PR Health configuration settings

int32
required

Days without activity before an open PR counts as aging. Must be lower than rottingDays.

int32
required

Days without activity before an open PR counts as rotting. Must be higher than agingDays.

date | null

The team's own cutoff: pull requests opened before this UTC date are left out of every PR Health figure, counts and dollar estimates alike. Null on read when the team has not set one: counts then cover the pull requests opened since defaultCountsSince (the last 6 months), and dollar estimates start at defaultCutoffDate. On write, a custom date between 2008-01-01 and today UTC; absent or null leaves the stored date unchanged.

boolean | null

False when cutoffDate is the team's own date; true when the team has none and the default applies (counts from defaultCountsSince, dollar estimates from defaultCutoffDate); null when the team has no date and the organization no coding-assistant usage. On write, true clears the custom date and restores the default, and any cutoffDate in the same body is ignored.

excludedRepos
array of strings | null

Repositories (owner/name) left out of every PR Health figure, matched case-insensitively. Returned sorted; an empty list on write clears them. At most 200.

excludedRepos
automationPatterns
array of strings | null

Custom regular expressions (PostgreSQL syntax, case-insensitive) matched against a pull request's title and author login; a match puts the pull request in the automation bucket. An empty list on write clears them. At most 20, each at most 200 characters, and none may match an empty string.

automationPatterns
boolean | null

The team's default for pricing and listing AI-assisted pull requests only. True when never set.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*