---
title: "Update Shield config."
method: PUT
path: "/v1/shield/config"
tags: ["Shield"]
---

# Update Shield config.

`PUT /v1/shield/config`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/shield/config`
- Auth: HTTP bearer

Replaces the Shield configuration for the caller's project. Requires the Pro
plan or higher.

## Request body

- ScopeConfig
  - `enabled` boolean
  - `inject_noai_headers` boolean: Adds `X-Robots-Tag: noai, noimageai` to proxied responses.
  - `tdm_reservation` boolean: Adds `tdm-reservation: 1` (EU DSM Directive text-and-data-mining opt-out).
  - `block_impersonators` boolean: Block crawlers whose source IP fails verification against configured ranges. Off by default: stale ranges must not break legitimate bots.
  - `category_defaults` object: Per-category default action, keyed by crawler category.

## Response `200`

Updated shield configuration

- ScopeConfig
  - `enabled` boolean
  - `inject_noai_headers` boolean: Adds `X-Robots-Tag: noai, noimageai` to proxied responses.
  - `tdm_reservation` boolean: Adds `tdm-reservation: 1` (EU DSM Directive text-and-data-mining opt-out).
  - `block_impersonators` boolean: Block crawlers whose source IP fails verification against configured ranges. Off by default: stale ranges must not break legitimate bots.
  - `category_defaults` object: Per-category default action, keyed by crawler category.

## Other responses

- `401`: Missing or invalid credentials
- `403`: Requires Pro plan, the waf:write scope, or a project-scoped token
- `500`: Internal error

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)