Get Agent Skill Candidate Review

GET

https://api.getzep.com/api/v4/agents/:agent_uuid/skill-candidates/:review_uuid

GET

/api/v4/agents/:agent_uuid/skill-candidates/:review_uuid

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.skill.candidate.get(
    agent_uuid="agent_uuid",
    review_uuid="review_uuid",
)

{
  "candidate_count": 1,
  "candidates": [
    {
      "agent_versions": [
        "2026.09.01"
      ],
      "base_versions": [
        {
          "agent_versions": [
            "2026.09.01"
          ],
          "description": "Refund a duplicate charge after you confirm the duplicate payment.",
          "do_not_use_when": [
            "The payment has not settled."
          ],
          "markdown": "Confirm the duplicate charge before issuing a refund.",
          "name": "Refund a duplicate charge",
          "skill_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
          "version": 1
        }
      ],
      "confidence": 0.5,
      "decision": "add",
      "description": "Refund a duplicate charge after you confirm the duplicate payment.",
      "do_not_use_when": [
        "The payment has not settled."
      ],
      "evidence": [
        {
          "imported_provider": "braintrust",
          "occurred_at": "2026-01-01T00:00:00Z",
          "outcome": "succeeded",
          "polarity": "supporting",
          "source_kind": "trace_summary",
          "trace_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
          "verification": "external"
        }
      ],
      "kind": "procedure",
      "markdown": "Confirm the duplicate charge before issuing a refund.",
      "name": "Refund a duplicate charge",
      "package_name": "payments",
      "task_family": "support/refund",
      "uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa"
    }
  ],
  "created_at": "2026-01-01T00:00:00Z",
  "import_review_required": false,
  "reason_code": "evidence_insufficient",
  "results": [
    {
      "base_versions": [
        {
          "agent_versions": [
            "2026.09.01"
          ],
          "description": "Refund a duplicate charge after you confirm the duplicate payment.",
          "do_not_use_when": [
            "The payment has not settled."
          ],
          "markdown": "Confirm the duplicate charge before issuing a refund.",
          "name": "Refund a duplicate charge",
          "skill_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
          "version": 1
        }
      ],
      "candidate_uuids": [
        "6a906e70-50ca-4e43-a874-5fcae02a71fa"
      ],
      "decision": "add",
      "target_skill_uuids": [
        "6a906e70-50ca-4e43-a874-5fcae02a71fa"
      ],
      "uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa"
    }
  ],
  "reviewed_at": "2026-01-01T00:00:00Z",
  "revision": 1,
  "status": "active",
  "task_family": "support/refund",
  "uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa"
}

Get Agent Skill Candidate Review. 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

review_uuidstringRequired

Candidate review UUID

Response

candidate_countintegerOptional

The service returns the number of related resources.

candidateslist of objectsOptional

The service returns candidate Skills.

created_atstringOptional

The service returns when Zep created this resource.

import_review_requiredbooleanOptional

ImportReviewRequired reports whether any evidence import requires approval.

reason_codestringOptional

The service returns the code that explains this result.

resultslist of objectsOptional

The service returns evaluation results.

reviewed_atstringOptional

The service returns when the review occurred.

revisionintegerOptional

The service returns the current revision number.

statusstringOptional

The service returns the lifecycle status.

task_familystringOptional

The service returns the task-family slug.

uuidstringOptional

The service returns the UUID that identifies this resource.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

503

Service Unavailable Error