Invalidate Agent Verifier Evidence

POST

https://api.getzep.com/api/v4/agents/:agent_uuid/verifiers/:verifier_uuid/invalidate-evidence

POST

/api/v4/agents/:agent_uuid/verifiers/:verifier_uuid/invalidate-evidence

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.verifier.invalidate_evidence(
    agent_uuid="agent_uuid",
    verifier_uuid="verifier_uuid",
    reason="acknowledged_gap",
    verifier_revisions=[
        1
    ],
)

{
  "affected_skill_uuids": [
    "6a906e70-50ca-4e43-a874-5fcae02a71fa"
  ],
  "agent_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
  "created_at": "2026-01-01T00:00:00Z",
  "created_by": {
    "principal_id": "member-123",
    "principal_type": "member"
  },
  "reason": "acknowledged_gap",
  "task": {
    "completed_at": "string",
    "created_at": "string",
    "error": {
      "code": "string",
      "details": {},
      "message": "string",
      "param": "string",
      "request_id": "string"
    },
    "progress": {
      "stage": "string"
    },
    "result": {
      "content_policy": {
        "category_keys": [
          "health"
        ],
        "dropped_count": 0,
        "failed_count": 1,
        "retained_count": 7,
        "revision": 3,
        "status": "complete",
        "violated": false,
        "violated_count": 2
      },
      "edge_uuid": "7a1f3c2e-4b5d-4e6f-8a9b-0c1d2e3f4a5b",
      "edges": [
        {
          "edge_uuid": "7a1f3c2e-4b5d-4e6f-8a9b-0c1d2e3f4a5b",
          "source_node_uuid": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
          "target_node_uuid": "c3d4e5f6-a7b8-4c9d-8e1f-2a3b4c5d6e7f"
        }
      ],
      "episode_uuid": "f6a7b8c9-d0e1-4f2a-9b4c-5d6e7f8091a2",
      "episodes": [
        {
          "content_policy": {
            "category_keys": [
              "health"
            ],
            "dropped_count": 0,
            "failed_count": 1,
            "retained_count": 7,
            "revision": 3,
            "status": "complete",
            "violated": false,
            "violated_count": 2
          },
          "episode_uuid": "f6a7b8c9-d0e1-4f2a-9b4c-5d6e7f8091a2"
        }
      ],
      "hyperedge_uuid": "d4e5f6a7-b8c9-4d0e-9f2a-3b4c5d6e7f80",
      "skill_uuid": "e5f6a7b8-c9d0-4e1f-8a3b-4c5d6e7f8091",
      "source_node_uuid": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
      "target_node_uuid": "c3d4e5f6-a7b8-4c9d-8e1f-2a3b4c5d6e7f"
    },
    "started_at": "string",
    "status": "pending",
    "type": "string",
    "updated_at": "string",
    "uuid": "string"
  },
  "uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
  "verifier_revisions": [
    1
  ],
  "verifier_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa"
}

Invalidate Agent Verifier Evidence. Agent Skills is in closed release. Zep enables Agent Skills only for select accounts. A request from an account without access returns 403 permission_denied. To get access, contact support@getzep.com.

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

reasonstringRequired

The developer supplies why evidence from these verifier revisions is invalid.

verifier_revisionslist of integersRequired

Verifier revisions whose accepted evidence is no longer valid.

Response

Accepted

affected_skill_uuidslist of stringsOptional

The service returns UUIDs of Skills affected by this invalidation.

agent_uuidstringOptional

The service returns the UUID of the owning Agent.

created_atstringOptional

The service returns when Zep created this resource.

created_byobjectOptional

The service returns the principal that created this assertion.

reasonstringOptional

The service returns why the Verifier revisions were invalidated.

taskobjectOptional

The service returns the Task that tracks this asynchronous operation.

uuidstringOptional

The service returns the UUID that identifies this resource.

verifier_revisionslist of integersOptional

The service returns revisions of the Verifiers affected by this invalidation.

verifier_uuidstringOptional

The service returns the UUID of the Verifier linked to this invalidation.

Errors

400

Bad Request Error

404

Not Found Error

409

Conflict Error