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": [
        "string"
      ],
      "base_versions": [
        {
          "agent_versions": [
            "string"
          ],
          "description": "string",
          "do_not_use_when": [
            "string"
          ],
          "markdown": "string",
          "name": "string",
          "skill_uuid": "string",
          "version": 1
        }
      ],
      "confidence": 1.1,
      "decision": "string",
      "description": "string",
      "do_not_use_when": [
        "string"
      ],
      "evidence": [
        {
          "imported_provider": "braintrust",
          "occurred_at": "2026-01-01T00:00:00Z",
          "outcome": "succeeded",
          "polarity": "supporting",
          "source_kind": "summary",
          "trajectory_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
          "verification": "external"
        }
      ],
      "kind": "string",
      "markdown": "string",
      "name": "string",
      "package_name": "string",
      "task_family": "string",
      "uuid": "string"
    }
  ],
  "created_at": "string",
  "import_review_required": false,
  "reason_code": "string",
  "results": [
    {
      "base_versions": [
        {
          "agent_versions": [
            "string"
          ],
          "description": "string",
          "do_not_use_when": [
            "string"
          ],
          "markdown": "string",
          "name": "string",
          "skill_uuid": "string",
          "version": 1
        }
      ],
      "candidate_uuids": [
        "string"
      ],
      "decision": "string",
      "target_skill_uuids": [
        "string"
      ],
      "uuid": "string"
    }
  ],
  "reviewed_at": "string",
  "revision": 1,
  "status": "string",
  "task_family": "string",
  "uuid": "string"
}

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

candidateslist of objectsOptional

created_atstringOptional

import_review_requiredbooleanOptional

ImportReviewRequired reports whether any evidence import requires approval.

reason_codestringOptional

resultslist of objectsOptional

reviewed_atstringOptional

revisionintegerOptional

statusstringOptional

task_familystringOptional

uuidstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

503

Service Unavailable Error