## List

`$ stl builds:diagnostics list`

**get** `/v0/builds/{buildId}/diagnostics`

Get the list of diagnostics for a given build.

If no language targets are specified, diagnostics for all languages are returned.

### Parameters

- `--build-id: string`

  Build ID

- `--cursor: optional string`

  Pagination cursor from a previous response

- `--limit: optional number`

  Maximum number of diagnostics to return, defaults to 100 (maximum: 100)

- `--severity: optional "fatal" or "error" or "warning" or "note"`

  Includes the given severity and above (fatal > error > warning > note).

- `--targets: optional string`

  Optional comma-delimited list of language targets to filter diagnostics by

### Returns

- `unnamed_schema_3: object { data, has_more, next_cursor }`

  - `data: array of BuildDiagnostic`

    - `code: string`

      The kind of diagnostic.

    - `ignored: boolean`

      Whether the diagnostic is ignored in the Stainless config.

    - `level: "fatal" or "error" or "warning" or "note"`

      The severity of the diagnostic.

      - `"fatal"`

      - `"error"`

      - `"warning"`

      - `"note"`

    - `message: string`

      A description of the diagnostic.

    - `more: object { markdown, type }  or object { raw, type }`

      - `markdown: object { markdown, type }`

        - `markdown: string`

        - `type: "markdown"`

          - `"markdown"`

      - `raw: object { raw, type }`

        - `raw: string`

        - `type: "raw"`

          - `"raw"`

    - `config_ref: optional string`

      A JSON pointer to a relevant field in the Stainless config.

    - `oas_ref: optional string`

      A JSON pointer to a relevant field in the OpenAPI spec.

  - `has_more: boolean`

  - `next_cursor: optional string`

### Example

```cli
stl builds:diagnostics list \
  --build-id buildId
```