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

# List Agent Skill Compilation Outcomes

GET https://api.getzep.com/api/v4/agents/{agent_uuid}/learning-runs

Reference: https://docs-beta.getzep.com/sdk-reference/agent/learning/list-runs

## 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

### Query parameters

- `task_family` (string, optional) — Task family
- `limit` (integer, optional) — Page size
- `cursor` (string, optional) — Opaque page cursor

## Response

### 200

OK

- `items` (list of v4.AgentSkillCompilationOutcome, optional)
- `next_cursor` (string, optional)
- `total_size` (integer, optional)

## Errors

### 400 Bad Request Error

Bad Request

- `error` (v4.ErrorBody, optional)

### 404 Not Found Error

Not Found

- `error` (v4.ErrorBody, optional)

## Types

### v4.AgentSkillCompilationOutcome

- `agent_uuid` (string, optional)
- `attempts` (integer, optional)
- `candidate_count` (integer, optional)
- `compilation_identity` (string, optional)
- `compilation_window_uuid` (string, optional)
- `created_at` (string, optional)
- `decision` (string, optional)
- `proposal_count` (integer, optional)
- `reason_text` (string, optional)
- `rejected_add_count` (integer, optional) — RejectedAddCount is the count of add proposals that the Reflector, the proposal scanner, or the Curator rejected in this compilation.
- `rejection_class` (enum, optional)
  - Allowed values: `no_eligible_trajectories`, `reflector_invalid_output`, `applicability_ungrounded`, `corroboration_insufficient`, `scanner_rejected`, `curator_rejected`, `curator_attempts_exhausted`, `prompt_budget_exceeded`, `provider_error`
- `stage` (string, optional)
- `task_family` (string, optional)
- `trajectory_count` (integer, optional)
- `uuid` (string, optional)

### v4.ErrorBody

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

## Examples

**Response**

```json
{
  "items": [
    {
      "agent_uuid": "string",
      "attempts": 1,
      "candidate_count": 1,
      "compilation_identity": "string",
      "compilation_window_uuid": "string",
      "created_at": "string",
      "decision": "string",
      "proposal_count": 1,
      "reason_text": "string",
      "rejected_add_count": 1,
      "rejection_class": "no_eligible_trajectories",
      "stage": "string",
      "task_family": "string",
      "trajectory_count": 1,
      "uuid": "string"
    }
  ],
  "next_cursor": "string",
  "total_size": 1
}
```