---
title: "Run Clusterlint Checks on a Kubernetes Cluster"
method: POST
path: "/v2/kubernetes/clusters/{cluster_id}/clusterlint"
tags: ["DigitalOcean-public.v2-new_Kubernetes"]
---

# Run Clusterlint Checks on a Kubernetes Cluster

`POST /v2/kubernetes/clusters/{cluster_id}/clusterlint`

Clusterlint helps operators conform to Kubernetes best practices around
resources, security and reliability to avoid common problems while operating
or upgrading the clusters.

To request a clusterlint run on your cluster, send a POST request to
`/v2/kubernetes/clusters/$K8S_CLUSTER_ID/clusterlint`. This will run all
checks present in the `doks` group by default, if a request body is not
specified. Optionally specify the below attributes.

For information about the available checks, please refer to
[the clusterlint check documentation](https://github.com/digitalocean/clusterlint/blob/master/checks.md).

## Path parameters

- `cluster_id` string, uuid, required

## Request body

- ClusterlintRequest
  - `include_groups` string[] — An array of check groups that will be run when clusterlint executes checks.
  - `include_checks` string[] — An array of checks that will be run when clusterlint executes checks.
  - `exclude_groups` string[] — An array of check groups that will be omitted when clusterlint executes checks.
  - `exclude_checks` string[] — An array of checks that will be run when clusterlint executes checks.

## Response `202`

The response is a JSON object with a key called `run_id` that you can later use to fetch the run results.

- object
  - `run_id` string — ID of the clusterlint run that can be used later to fetch the diagnostics.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

[API](https://skmtc.net/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.net/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)