REST API endpoints for code quality

Get a code quality setup configuration

Gets a code quality setup configuration.

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

Fine-grained access tokens for "Get a code quality setup configuration"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Administration" repository permissions (write)

Parameters for "Get a code quality setup configuration"

Headers
Name, Type, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Path parameters
Name, Type, Description
`owner` string Required The account owner of the repository. The name is not case sensitive.
`repo` string Required The name of the repository without the `.git` extension. The name is not case sensitive.

HTTP response status codes for "Get a code quality setup configuration"

Status code	Description
`200`	OK
`403`	Response if the user is not authorized to access Code quality for this repository.
`404`	Resource not found
`503`	Service unavailable

Code samples for "Get a code quality setup configuration"

Request example

get/repos/{owner}/{repo}/code-quality/setup

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/code-quality/setup

Response

Status: 200

{
  "state": "configured",
  "languages": [
    "javascript-typescript",
    "python"
  ],
  "runner_type": "standard",
  "runner_label": null,
  "updated_at": "2023-01-01T00:00:00Z",
  "schedule": "weekly"
}

Update a code quality setup configuration

Updates a code quality setup configuration.

Fine-grained access tokens for "Update a code quality setup configuration"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Administration" repository permissions (write)

Parameters for "Update a code quality setup configuration"

Headers
Name, Type, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Path parameters
Name, Type, Description
`owner` string Required The account owner of the repository. The name is not case sensitive.
`repo` string Required The name of the repository without the `.git` extension. The name is not case sensitive.

Body parameters
Name, Type, Description
`state` string The desired state of code quality setup. Can be one of: `configured`, `not-configured`
`runner_type` string Runner type to be used. Can be one of: `standard`, `labeled`
`runner_label` string or null Runner label to be used if the runner type is labeled.
`languages` array of strings Languages to be analyzed. Supported values are: `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, `ruby`

HTTP response status codes for "Update a code quality setup configuration"

Status code	Description
`200`	OK
`202`	Accepted
`403`	Response if the repository is archived or if Code quality is not enabled for this repository
`404`	Resource not found
`409`	Response if there is already a code quality setup configuration update in progress
`422`	Response if the configuration change cannot be made
`503`	Service unavailable

Code samples for "Update a code quality setup configuration"

Request example

patch/repos/{owner}/{repo}/code-quality/setup

curl -L \
  -X PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/code-quality/setup \
  -d '{"state":"configured","languages":["javascript-typescript","python","ruby"]}'

Response

Status: 202

{
  "run_id": 42,
  "run_url": "https://api.github.com/repos/octocat/hello-world/actions/runs/42"
}