---
title: "Set a directory listing's verification tier"
method: PUT
path: "/v1/admin/agents/{agent_id}/verification-tier"
tags: ["Admin"]
---

# Set a directory listing's verification tier

`PUT /v1/admin/agents/{agent_id}/verification-tier`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/admin/agents/{agent_id}/verification-tier`
- Auth: HTTP bearer

Platform admins only. Unknown tiers are refused rather than demoted to `unverified`.

## Path parameters

- `agent_id` string, uuid, required

## Request body

- object
  - `tier` 'unverified' | 'platform_reviewed' | 'identity_verified' | 'enterprise', required
  - `notes` string, nullable: Internal review notes, never public

## Response `200`

Tier set

- object
  - `agent_id` string, uuid
  - `tier` string

## Other responses

- `400`: Unknown tier
- `403`: Not a platform admin
- `404`: Agent not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)