> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pandaprobe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform errors

> Distinguish failed requests, deadlines, insufficient evidence, and uncertain creation

Catch errors at the operation boundary. Authentication errors, missing resources, rate limits, read transport failures, deadlines, and incomplete evaluation evidence have separate types.

`CreationOutcomeUnknown` means the server may already have created a billable evaluation. Keep that outcome distinct from a known failed request; do not create another run automatically. Cancellation is separate from these operational errors.

| Error | Meaning |
| - | - |
| `PlatformError` | Base platform error |
| `ApiError` | Non-success HTTP response; includes status and request ID when available |
| `AuthenticationError` | HTTP 401 or 403 |
| `NotFoundError` | HTTP 404 |
| `RateLimitError` | HTTP 429 after applicable read retries |
| `TransportError` | A read could not complete through the transport |
| `ApiDeadlineExceeded` | Operation or polling deadline exceeded |
| `InvalidResponseError` | Invalid JSON, response shape, or mismatched response identity |
| `CreationOutcomeUnknown` | A create may have reached the server; response cannot establish its outcome |
| `EvaluationFailed` | Evaluation ended `FAILED` or `CANCELLED` |
| `InsufficientEvidence` | Required trace/metric pairs are missing, duplicated, or unusable |

## On this page

[ApiDeadlineExceeded](#apideadlineexceeded), [ApiError](#apierror), [AuthenticationError](#authenticationerror), [CreationOutcomeUnknown](#creationoutcomeunknown), [EvaluationFailed](#evaluationfailed), [InsufficientEvidence](#insufficientevidence), [InvalidResponseError](#invalidresponseerror), [NotFoundError](#notfounderror), [PlatformError](#platformerror), [RateLimitError](#ratelimiterror), [TransportError](#transporterror).

## `ApiDeadlineExceeded`

```python theme={null}
from pandaprobe.api import ApiDeadlineExceeded
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L33)

## `ApiError`

```python theme={null}
from pandaprobe.api import ApiError
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L10)

### Constructor

```text theme={null}
ApiError(message: str, *, status_code: int, request_id: str | None=None)
```

| Parameter | Type | Default / passing |
| - | - | - |
| `message` | `str` | Required |
| `status_code` | `int` | Required; keyword only |
| `request_id` | `str \| None` | `None`; keyword only |

### Fields and properties

| Name | Type | Default / contract |
| - | - | - |
| `status_code` | `int` | Instance value; Instance attribute. |
| `request_id` | `str \| None` | Instance value; Instance attribute. |

## `AuthenticationError`

```python theme={null}
from pandaprobe.api import AuthenticationError
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L17)

### Constructor

```text theme={null}
AuthenticationError(message: str, *, status_code: int, request_id: str | None=None)
```

| Parameter | Type | Default / passing |
| - | - | - |
| `message` | `str` | Required |
| `status_code` | `int` | Required; keyword only |
| `request_id` | `str \| None` | `None`; keyword only |

### Fields and properties

| Name | Type | Default / contract |
| - | - | - |
| `status_code` | `int` | Instance value; Instance attribute. |
| `request_id` | `str \| None` | Instance value; Instance attribute. |

## `CreationOutcomeUnknown`

```python theme={null}
from pandaprobe.api import CreationOutcomeUnknown
```

A create may have reached the server. Retrying could create a billable duplicate.

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L41)

## `EvaluationFailed`

```python theme={null}
from pandaprobe.api import EvaluationFailed
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L45)

### Constructor

```text theme={null}
EvaluationFailed(run_id: str, status: str)
```

| Parameter | Type | Default / passing |
| - | - | - |
| `run_id` | `str` | Required |
| `status` | `str` | Required |

### Fields and properties

| Name | Type | Default / contract |
| - | - | - |
| `run_id` | `str` | Instance value; Instance attribute. |

## `InsufficientEvidence`

```python theme={null}
from pandaprobe.api import InsufficientEvidence
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L51)

### Constructor

```text theme={null}
InsufficientEvidence(run_id: str, missing: list[tuple[str, str]])
```

| Parameter | Type | Default / passing |
| - | - | - |
| `run_id` | `str` | Required |
| `missing` | `list[tuple[str, str]]` | Required |

### Fields and properties

| Name | Type | Default / contract |
| - | - | - |
| `run_id` | `str` | Instance value; Instance attribute. |
| `missing` | `list[tuple[str, str]]` | Instance value; Instance attribute. |

## `InvalidResponseError`

```python theme={null}
from pandaprobe.api import InvalidResponseError
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L37)

## `NotFoundError`

```python theme={null}
from pandaprobe.api import NotFoundError
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L21)

### Constructor

```text theme={null}
NotFoundError(message: str, *, status_code: int, request_id: str | None=None)
```

| Parameter | Type | Default / passing |
| - | - | - |
| `message` | `str` | Required |
| `status_code` | `int` | Required; keyword only |
| `request_id` | `str \| None` | `None`; keyword only |

### Fields and properties

| Name | Type | Default / contract |
| - | - | - |
| `status_code` | `int` | Instance value; Instance attribute. |
| `request_id` | `str \| None` | Instance value; Instance attribute. |

## `PlatformError`

```python theme={null}
from pandaprobe.api import PlatformError
```

Base class for platform API errors.

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L6)

## `RateLimitError`

```python theme={null}
from pandaprobe.api import RateLimitError
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L25)

### Constructor

```text theme={null}
RateLimitError(message: str, *, status_code: int, request_id: str | None=None)
```

| Parameter | Type | Default / passing |
| - | - | - |
| `message` | `str` | Required |
| `status_code` | `int` | Required; keyword only |
| `request_id` | `str \| None` | `None`; keyword only |

### Fields and properties

| Name | Type | Default / contract |
| - | - | - |
| `status_code` | `int` | Instance value; Instance attribute. |
| `request_id` | `str \| None` | Instance value; Instance attribute. |

## `TransportError`

```python theme={null}
from pandaprobe.api import TransportError
```

[Source declaration](https://github.com/chirpz-ai/pandaprobe-sdk/blob/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python/src/pandaprobe/api/errors.py#L29)

***

Signatures and fields are generated from the [SDK source](https://github.com/chirpz-ai/pandaprobe-sdk/tree/92d8c37fba00e87ac6f0104cd293990aa5d5e621/libraries/python). See the [import index](https://docs.pandaprobe.com/reference/python/overview.md#public-import-index) for available entry points.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.