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

# November 4, 2026

> Errors that say what to do, with the fields an agent needs

**November 4, 2026**

Errors that say what to do, with the fields an agent needs

## Improved

**Error responses carry structured hints**

Some errors now add fields to the `errors` object, next to `message`, `type` and `code`, which do not change. A client that ignores them keeps working.

* `InvalidParam` on a setting the crawler does not have: when another crawler of the same site has it, the message says so ("Unknown parameter: phone. Did you mean functions.get\_phone\_numbers on leboncoin-iter-listings-with-phone?") and the response adds `param` and `suggestion`, with the `crawler` id and the `param` to send there. See [Update Squid](https://docs.lobstr.io/docs/update-squid.md).
* `TaskNotValidError`: the message shows the value received and the crawler's own example ("The 'url' format is not valid for facebook-group-posts-scraper: got [https://www.facebook.com/somepage](https://www.facebook.com/somepage). Expected something like [https://www.facebook.com/groups/211270969394435/](https://www.facebook.com/groups/211270969394435/)"), and the response adds `param` and `example`. See [Add Tasks](https://docs.lobstr.io/docs/add-tasks.md).
* `DuplicateSquid`: squid names are unique per account. The message names the squid ("A squid named Reviews already exists.") and the response adds `squid`, the id of the squid that has the name, to reuse it instead of creating it again. See [Create Squid](https://docs.lobstr.io/docs/create-squid.md).

```json theme={null}
{
  "errors": {
    "message": "Unknown parameter: phone. Did you mean functions.get_phone_numbers on leboncoin-iter-listings-with-phone?",
    "type": "InvalidParam",
    "code": 400,
    "param": "phone",
    "suggestion": { "crawler": "7bc4acdb18f2b90fdd5eb42b8e8251e9", "param": "functions.get_phone_numbers" }
  }
}
```

## Fixed

**Leboncoin Listings & Phone Search Export: no `phone` alias**

The settings page said the old function name `phone` was still accepted. It is not: use `functions.get_phone_numbers`. See [Update Settings](https://docs.lobstr.io/examples/leboncoin-iter-listings-with-phone/update-settings.md).


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