---
title: "Select an exact badge grading profile"
method: PUT
path: "/api/registry/agents/{encodedUrl}/grading-profile"
tags: ["Agent Compliance"]
---

# Select an exact badge grading profile

`PUT /api/registry/agents/{encodedUrl}/grading-profile`

## Request

- Base URL: `https://agenticadvertising.org`
- URL: `https://agenticadvertising.org/api/registry/agents/{encodedUrl}/grading-profile`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://agenticadvertising.org/authorize`
    - Token URL: `https://agenticadvertising.org/token`

Selects Legacy or Strict Spec grading for one exact agent role and AdCP version. Requires a current immutable assessment, organization owner/admin authorization, revision compare-and-swap, and an idempotency key. Sandbox is preview-only. The selection itself does not contact the agent.

## Path parameters

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

## Request body

- object
  - `organization_id` string, required
  - `role` 'media-buy' | 'creative' | 'signals' | 'governance' | 'brand' | 'sponsored-intelligence', required
  - `adcp_version` string, required
  - `selected_profile` 'legacy' | 'spec', required
  - `assessment_id` string, uuid, required
  - `expected_revision` integer, required
  - `acknowledge_public_impact` boolean
  - `idempotency_key` string, uuid, required
  - `admin_override_reason` string

## Response `200`

Selection committed and audited

- object
  - `selected_profile` 'legacy' | 'spec', required
  - `revision` string, required
  - `public_effect` 'unchanged' | 'issue' | 'restore' | 'regrade' | 'degrade' | 'revoke', required
  - `replayed` boolean, required
  - `source_run_id` string, uuid, required
  - `token_refresh` 'completed' | 'scheduled', required

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Organization owner/admin required
- `409`: Stale assessment/revision, disabled selection, or impact confirmation required
- `500`: Server error

## Changes

- **2026-09-16** `9fd74b5fc890`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/changes/api/registry/agents/:encodedUrl/grading-profile/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)