Revoke Agent Verifier

POST

https://api.getzep.com/api/v4/agents/:agent_uuid/verifiers/:verifier_uuid/revoke

POST

/api/v4/agents/:agent_uuid/verifiers/:verifier_uuid/revoke

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.verifier.revoke(
    agent_uuid="agent_uuid",
    verifier_uuid="verifier_uuid",
    expected_revision=1,
)

{
  "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"
}

Authentication

AuthorizationApi-Key

Type "Api-Key" followed by a space and the project API key.

Path parameters

agent_uuidstringRequired

Agent UUID

verifier_uuidstringRequired

Verifier UUID

Request

Request body

expected_revisionintegerRequired>=1

The current verifier revision used for optimistic concurrency.

Response

agent_uuidstringOptional

The owning Agent UUID.

capabilitiesmap from strings to anyOptional

Structured capabilities reported by the verifier integration.

classstringOptional

The immutable verifier class.

created_atstringOptional

The time the registration was created.

created_byobjectOptional

The authenticated principal that created this registration.

metadatamap from strings to anyOptional

Developer metadata used to organize the registration.

permitted_strengthslist of enumsOptional

Verification strengths this registration may assert.

Allowed values:

principal_bindingslist of objectsOptional

Exact authenticated principals permitted to submit verifier assertions.

revisionintegerOptional

The revision required by the next update or revoke request.

revoked_atstringOptional

The time the registration was revoked.

statusenumOptional

The registration lifecycle status.

Allowed values:

updated_atstringOptional

The time the registration was last updated.

uuidstringOptional

The stable verifier registration UUID.

verifier_idstringOptional

The developer-assigned verifier identifier, unique within the Agent.

Errors

400

Bad Request Error

404

Not Found Error

409

Conflict Error