Skip to content

docs(errors): warn that exception_to_status is not merged with defaults #2291

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
soyuka merged 2 commits into from
Jun 11, 2026
Merged

docs(errors): warn that exception_to_status is not merged with defaults #2291

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6a1c933
docs(errors): warn that exception_to_status is not merged with defaults
soyuka Jun 11, 2026
f146a3e
docs(errors): apply prettier formatting
soyuka Jun 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions core/errors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -164,6 +164,13 @@ return [
];
```

> [!WARNING] The `exception_to_status` configuration is **not merged** with the defaults: as soon as
> you declare your own mapping, it replaces the built-in one entirely. If you omit the default
> handlers shown above, exceptions that were previously mapped to `400` (such as the
> `Symfony\Component\Serializer\Exception\ExceptionInterface` thrown when denormalizing a relation
> to a non-existing item, or an invalid backed enum value) will fall through to the `500` fallback.
> Always keep the default lines and append your custom mappings to them.

Any type of `Exception` can be thrown, API Platform will convert it to a Symfony's `HttpException`
(note that it means the exception will be flattened and lose all of its custom properties). The
framework also takes care of serializing the error description according to the request format. For
Expand Down
Loading