Transforms
Field: remove
Remove a JSON value at a configured path from the request or response.
What it does
This transform removes the JSON value at the configured extra-body path. In the request phase it edits the outgoing upstream payload. In the response phase it edits the payload returned to the client.
When the path does not exist, the transform changes nothing.
Request paths reasoning.effort, reasoning.summary, reasoning.mode, reasoning.budget_tokens, and reasoning.display control normalized reasoning settings. Other paths keep their extra-body behavior.
Removing a reasoning setting also removes its native value. Protocol conversion cannot restore it from an earlier request.
Reference
| Property | Value |
|---|---|
| Type ID | field_remove |
| Phase | request, response |
| Scopes | Provider |
When to use
- An upstream rejects a vendor-specific field that clients send.
- You want to hide a response field from clients behind one Provider.
Configuration
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | Yes | — | Dot-separated extra-body path of the value to remove, for example metadata.tags. |
Example rule
{
"transform": "field_remove",
"enabled": true,
"phase": "request",
"models": [
"*"
],
"config": {
"path": "metadata"
}
}