---
title: "Get Shield config."
method: GET
path: "/v1/shield/config"
tags: ["Shield"]
---

# Get Shield config.

`GET /v1/shield/config`

## Request

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

Returns the Shield configuration (default action, challenge settings) for the
caller's project.

## Response `200`

Shield configuration for the caller's project

- 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`: Token lacks the waf:read scope or is not project-scoped
- `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)