{
 "documentation_revision": 10,
 "api_revision": 58,
 "source": "Endpoints.all + Learn.endpoints + McpTools",
 "operation": {
  "summary": "Complete interaction samples for every kind (notice, question, html, text): the POST /v1/interactions body, the reply and the answer it produces (JSON). For cards that decide or watch (Jev, Clef, the free camera change check), read https://bridgit.cc/learn/decisions.md",
  "method": "GET",
  "auth": true,
  "mcp_tool": "samples",
  "query": [
   {
    "name": "id",
    "description": "One sample, e.g. html-step",
    "type": "string",
    "required": false
   },
   {
    "name": "kind",
    "description": "Only samples of this kind",
    "type": "string",
    "required": false,
    "enum": [
     "notice",
     "question",
     "html",
     "text"
    ]
   }
  ],
  "developer_only": false,
  "capture": false,
  "body": [],
  "example": "GET /v1/samples?id=html-step",
  "idempotent": false,
  "path": "/v1/samples",
  "capability": "status",
  "returns": "api_revision, conventions, samples[id, kind, title, summary, request, answer, events, notes, page?, calls?]",
  "mcp_input_schema": {
   "type": "object",
   "properties": {
    "kind": {
     "description": "Only samples of this kind",
     "type": "string",
     "enum": [
      "notice",
      "question",
      "html",
      "text"
     ]
    },
    "id": {
     "description": "One sample, e.g. html-step",
     "type": "string"
    }
   },
   "required": []
  },
  "errors": ["not_found"],
  "requires": null
 }
}