> ## Documentation Index
> Fetch the complete documentation index at: https://hydrotuff-admin-mcp-new-docs-207c911.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Error Code Reference

> Machine-readable error codes returned by failed tasks.

# Error Code Reference

When a task fails, the response includes an error string. These are the standard error codes:

## Solver Errors

| Error               | Description                        |
| ------------------- | ---------------------------------- |
| `SOLVE_TIMEOUT`     | Task exceeded the time limit       |
| `EMPTY_TOKEN`       | Solver returned an empty token     |
| `BAD_REQUEST`       | Missing required parameters        |
| `HTTPCLOAK_MISSING` | httpcloak dependency not installed |
| `PROXY_ERROR`       | Proxy connection failed            |
| `NETWORK_ERROR`     | Network/SSL/TLS connection error   |

## API Errors

| Error            | Description                               |
| ---------------- | ----------------------------------------- |
| `NO_COOKIE`      | No cookie/token was obtained              |
| `UNKNOWN_TASK`   | Task ID not found                         |
| `RESULT_EXPIRED` | Result has been cleaned up (5 min TTL)    |
| `ALREADYCLAIMED` | Result already claimed by another request |

## Task-Type Specific

### hCaptcha

| Error              | Description               |
| ------------------ | ------------------------- |
| `HCAPTCHA_FAILED`  | hCaptcha challenge failed |
| `HCAPTCHA_TIMEOUT` | hCaptcha solve timed out  |

### Cloudflare Turnstile

| Error               | Description                |
| ------------------- | -------------------------- |
| `TURNSTILE_FAILED`  | Turnstile challenge failed |
| `TURNSTILE_TIMEOUT` | Turnstile solve timed out  |

### AWS WAF

| Error            | Description              |
| ---------------- | ------------------------ |
| `AWSWAF_FAILED`  | AWS WAF challenge failed |
| `AWSWAF_TIMEOUT` | AWS WAF solve timed out  |

### DataDome

| Error           | Description                             |
| --------------- | --------------------------------------- |
| `API_ERROR_405` | DataDome API returned 405               |
| `API_ERROR_403` | DataDome API returned 403 (invalid key) |

### Kasada

| Error            | Description                 |
| ---------------- | --------------------------- |
| `KASADA_FAILED`  | Kasada challenge failed     |
| `KASADA_TIMEOUT` | Kasada solve timed out      |
| `TL_FAILED`      | /tl endpoint request failed |
| `TL_EMPTY`       | /tl returned empty response |