## List

`builds.diagnostics.list(build_id, **kwargs) -> Page<BuildDiagnostic>`

**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: String`

  Pagination cursor from a previous response

- `limit: Float`

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

- `severity: :fatal | :error | :warning | :note`

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

  - `:fatal`

  - `:error`

  - `:warning`

  - `:note`

- `targets: String`

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

### Returns

- `class BuildDiagnostic`

  - `code: String`

    The kind of diagnostic.

  - `ignored: bool`

    Whether the diagnostic is ignored in the Stainless config.

  - `level: :fatal | :error | :warning | :note`

    The severity of the diagnostic.

    - `:fatal`

    - `:error`

    - `:warning`

    - `:note`

  - `message: String`

    A description of the diagnostic.

  - `more: BuildDiagnosticMore`

    - `class Markdown`

      - `markdown: String`

      - `type: :markdown`

        - `:markdown`

    - `class Raw`

      - `raw: String`

      - `type: :raw`

        - `:raw`

  - `config_ref: String`

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

  - `oas_ref: String`

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

### Example

```ruby
require "stainless_v0"

stainless = StainlessV0::Client.new(
  api_key: "My API Key",
  environment: "staging" # defaults to "production"
)

page = stainless.builds.diagnostics.list("buildId")

puts(page)
```