> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-beta.getzep.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-beta.getzep.com/_mcp/server.

# Revoke Agent Verifier

POST https://api.getzep.com/api/v4/agents/{agent_uuid}/verifiers/{verifier_uuid}/revoke
Content-Type: application/json

Reference: https://docs-beta.getzep.com/sdk-reference/agent/verifier/revoke

## Authentication

- `Authorization` header (required) (prefixed with ` Api-Key  `) — Type "Api-Key" followed by a space and the project API key.

## Request

### Path parameters

- `agent_uuid` (string, required) — Agent UUID
- `verifier_uuid` (string, required) — Verifier UUID

### Body (application/json)

This endpoint expects a v4.RevokeAgentVerifierRequest.

- `expected_revision` (integer, required) — The current verifier revision used for optimistic concurrency.

## Response

### 200

OK

- `agent_uuid` (string, optional) — The owning Agent UUID.
- `capabilities` (map from string to any, optional) — Structured capabilities reported by the verifier integration.
- `class` (string, optional) — The immutable verifier class.
- `created_at` (string, optional) — The time the registration was created.
- `created_by` (v4.AgentVerifierPrincipal, optional) — The authenticated principal that created this registration.
- `metadata` (map from string to any, optional) — Developer metadata used to organize the registration.
- `permitted_strengths` (list of enum, optional) — Verification strengths this registration may assert.
  - Allowed values: `tool_verified`, `customer_verified`, `externally_verified`
- `principal_bindings` (list of v4.AgentVerifierPrincipalBinding, optional) — Exact authenticated principals permitted to submit verifier assertions.
- `revision` (integer, optional) — The revision required by the next update or revoke request.
- `revoked_at` (string, optional) — The time the registration was revoked.
- `status` (enum, optional) — The registration lifecycle status.
  - Allowed values: `active`, `revoked`
- `updated_at` (string, optional) — The time the registration was last updated.
- `uuid` (string, optional) — The stable verifier registration UUID.
- `verifier_id` (string, optional) — The developer-assigned verifier identifier, unique within the Agent.

## Errors

### 400 Bad Request Error

Bad Request

- `error` (v4.ErrorBody, optional)

### 404 Not Found Error

Not Found

- `error` (v4.ErrorBody, optional)

### 409 Conflict Error

Conflict

- `error` (v4.ErrorBody, optional)

## Types

### v4.AgentVerifierPrincipal

- `principal_id` (string, required) — The exact principal identifier. Wildcards are not supported.
- `principal_type` (string, required) — The authenticated principal type: member, project-api-key, service, or mcp_user.

### v4.AgentVerifierPrincipalBinding

- `created_at` (string, optional) — The time the binding was created.
- `effective_strength` (enum, optional) — The verification strength assigned to this principal binding.
  - Allowed values: `tool_verified`, `customer_verified`, `externally_verified`
- `principal_id` (string, optional) — The exact principal identifier bound to this verifier.
- `principal_type` (string, optional) — The authenticated principal type bound to this verifier.

### v4.ErrorBody

- `code` (string, optional)
- `details` (map from string to any, optional)
- `message` (string, optional)
- `param` (string, optional)
- `request_id` (string, optional)

## Examples

**Request**

```json
{
  "expected_revision": 1
}
```

**Response**

```json
{
  "agent_uuid": "string",
  "capabilities": {},
  "class": "string",
  "created_at": "string",
  "created_by": {
    "principal_id": "string",
    "principal_type": "string"
  },
  "metadata": {},
  "permitted_strengths": [
    "tool_verified"
  ],
  "principal_bindings": [
    {
      "created_at": "string",
      "effective_strength": "tool_verified",
      "principal_id": "string",
      "principal_type": "string"
    }
  ],
  "revision": 1,
  "revoked_at": "string",
  "status": "active",
  "updated_at": "string",
  "uuid": "string",
  "verifier_id": "string"
}
```