---
title: "Update compliance opt-out"
method: PUT
path: "/api/registry/agents/{encodedUrl}/compliance/opt-out"
tags: ["Agent Compliance"]
---

# Update compliance opt-out

`PUT /api/registry/agents/{encodedUrl}/compliance/opt-out`

## Request

- Base URL: `https://agenticadvertising.org`
- URL: `https://agenticadvertising.org/api/registry/agents/{encodedUrl}/compliance/opt-out`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://agenticadvertising.org/authorize`
    - Token URL: `https://agenticadvertising.org/token`
- TypeScript: <https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/docs/api/registry/agents/:encodedUrl/compliance/opt-out/put.ts> (a function with typed inputs; its response is checked against the schema)

Opt an agent in or out of public compliance reporting. Opting out immediately revokes every active badge version. Re-enabling monitoring keeps badges suppressed until a fresh passing full-suite run earns them again; partial storyboard reruns cannot restore verification first. Requires authentication and ownership of the agent.

## Path parameters

- `encodedUrl` string, required: URL-encoded agent URL

## Request body

- object
  - `opt_out` boolean, required

## Response `200`

Updated metadata

- RegistryMetadata
  - `agent_url` string, required
  - `lifecycle_stage` 'development' | 'testing' | 'production' | 'deprecated', required
  - `compliance_opt_out` boolean, required
  - `badge_requalification_required` boolean, required: True after opt-out until a fresh full-suite compliance run completes badge requalification.
  - `monitoring_paused` boolean, required
  - `check_interval_hours` integer, required
  - `monitoring_paused_at` string, nullable, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400`: Invalid agent URL or opt_out value
- `401`: Authentication required
- `403`: Not authorized
- `500`: Server error

## Changes

- **2026-08-12** `9997582e1ad8`: 1 info
  - added the required property `badge_requalification_required` to the response with the `200` status
- **2026-04-23** `9f49db49a85b`: 1 info
  - the endpoint scheme security `oauth2` was added to the API
- **2026-04-17** `cf932b4414b1`: 1 breaking
  - removed the required property `platform_type` from the response with the `200` status
- **2026-04-13** `3e05257f30f1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/changes/api/registry/agents/:encodedUrl/compliance/opt-out/put.md)

---

[API](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) - [All operations](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/revisions/d8f6af89f253?raw)