# Response Samples

These are abbreviated response shapes from the live demo surface. They are examples, not local source of truth. Fetch fresh values from the API when building.

## Descriptor

```json
{
  "module": "curriculum",
  "surface": "alpha",
  "modelGate": {
    "authoritativeStorage": [
      "case.cf_document",
      "case.cf_item",
      "case.cf_association",
      "alpha.standards_source_release",
      "alpha.standards_source_row_binding",
      "alpha.knowledge_component",
      "alpha.knowledge_component_version",
      "alpha.kc_prerequisite",
      "alpha.kc_relation",
      "alpha.standard_kc_map"
    ],
    "alphaCurriculumBaseTables": "forbidden",
    "alphaCurriculumViews": "derived read conveniences only"
  },
  "quickstart": {
    "listComponents": "GET /alpha/curriculum/v1/components?kind=lesson&limit=10",
    "readTree": "GET /alpha/curriculum/v1/components/66666666-6666-4666-8666-666666666660/tree",
    "readGate": "GET /alpha/curriculum/v1/gates/bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbb0",
    "readGateNextForm": "GET /alpha/curriculum/v1/gates/bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbb0/next-form?studentId=student_demo"
  }
}
```

## Component Tree

```json
{
  "root_component_id": "66666666-6666-4666-8666-666666666660",
  "components": [
    {
      "component_id": "66666666-6666-4666-8666-666666666660",
      "kind": "course",
      "name": "Grade 3 Operations and Algebraic Thinking",
      "depth": 0,
      "stored_as": "case.cf_item"
    },
    {
      "component_id": "88888888-8888-4888-8888-888888888880",
      "kind": "lesson",
      "target_ref": {
        "module": "content",
        "content_id": "58612cab-9c46-426c-8c20-0e9f19c807c5",
        "content_version_id": "efcf3561-3a66-4825-9588-e792ef20c312",
        "content_kind": "question"
      },
      "renderer_ref": "renderer:qti-item",
      "renderer_kind": "renderer:qti-item",
      "stored_as": "case.cf_item"
    },
    {
      "component_id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbb0",
      "kind": "mastery_gate",
      "target_ref": {
        "module": "content",
        "content_id": "27cba337-7e16-a581-b45a-abe1ef9d22eb",
        "content_kind": "test_bank"
      },
      "renderer_ref": "renderer:qti-test",
      "renderer_kind": "renderer:qti-test",
      "passing_criteria_ref": "alpha.policy.gate.mastery_default",
      "stored_as": "case.cf_item"
    }
  ]
}
```

## Gate Next Form (intentionally blocked)

The demo gate is intentionally versionless. Launch fails closed until its bank/form/question graph pins exact Content versions, every referenced question has active governed item-scoped KC tags, and Content's exact-version release-eligibility read passes. A producer QC artifact is provenance only; it cannot replace or be appended to Content's server-owned QC receipt.

```json
{
  "type": "https://platform.timeback.com/problems/curriculum/invalid-gate-contract",
  "title": "Fix the mastery gate contract",
  "status": 422,
  "detail": "The mastery gate must identify one exact-version Content test bank.",
  "code": "curriculum:invalid_gate_contract"
}
```

## Registry KC and Prerequisite DAG

```json
{
  "knowledge_component": {
    "kc_id": "eeeeeeee-eeee-4eee-8eee-eeeeeeeeeee0",
    "definition": "Use arrays to reason about products.",
    "current_version_id": "702d7df3-ace5-5c28-99cf-c693dcf84f8e",
    "stored_as": "alpha.knowledge_component"
  },
  "prerequisites": [
    {
      "prerequisite_kc_id": "eeeeeeee-eeee-4eee-8eee-eeeeeeeeeee0",
      "dependent_kc_id": "dddddddd-dddd-4ddd-8ddd-ddddddddddd0",
      "stored_as": "alpha.kc_prerequisite"
    }
  ]
}
```

## Gate Remediation

```json
{
  "gate_component_id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbb0",
  "student_id": "student_demo",
  "remediation_entries": [
    {
      "reason": "never_learned",
      "assigned_kind": "lesson",
      "assigned_component_ref": "88888888-8888-4888-8888-888888888880"
    },
    {
      "reason": "forgot",
      "assigned_kind": "review",
      "assigned_component_ref": "99999999-9999-4999-8999-999999999990"
    },
    {
      "reason": "careless",
      "assigned_kind": "practice",
      "assigned_component_ref": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa0"
    }
  ],
  "results_owner": "Results owns the per-student inserted sequence."
}
```

## Problem JSON

```json
{
  "type": "https://platform.timeback.com/problems/curriculum/not-found",
  "title": "We could not find that curriculum record",
  "status": 404,
  "code": "curriculum:not_found",
  "detail": "No Curriculum Alpha route matched this request.",
  "requestId": "req_example",
  "traceId": "trace_example",
  "fieldErrors": []
}
```