{
 "domain": "anthropic-advanced",
 "generated_at": "2026-09-18",
 "records": [
  {
   "provider": "anthropic",
   "name": "thinking (content block)",
   "kind": "content_block",
   "description": "Reasoning block preceding text; thinking text is a summary (or '' when display omitted); signature = encrypted full reasoning, opaque, must be passed back unchanged with tool results.",
   "schema": {
    "type": "thinking",
    "thinking": "string (summary or empty)",
    "signature": "string (opaque, long on Claude 4+)"
   },
   "sdk_types": {
    "python": "ThinkingBlock / ThinkingBlockParam / BetaThinkingBlock",
    "node": "ThinkingBlock"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": {
    "type": "thinking",
    "thinking": "The user is asking for 2+2, which equals 4…",
    "signature": "EtQCCpoBCBEYAipAGx2p…"
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "think_01 on Haiku"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/thinking",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "redacted_thinking (content block)",
   "kind": "content_block",
   "description": "Safety-redacted reasoning: encrypted data, no text. Must be round-tripped unchanged; filtering by type=='thinking' alone breaks tool-use turns.",
   "schema": {
    "type": "redacted_thinking",
    "data": "string (opaque)"
   },
   "sdk_types": {
    "python": "RedactedThinkingBlock / RedactedThinkingBlockParam",
    "node": "RedactedThinkingBlock"
   },
   "status": [
    "DOCUMENTED"
   ],
   "example": null,
   "notes": null,
   "verification": null,
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/thinking",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "ThinkingConfig (request)",
   "kind": "request_object",
   "description": "thinking parameter variants.",
   "schema": {
    "oneOf": [
     {
      "type": "enabled",
      "budget_tokens": "int >= 1024, < max_tokens",
      "display": "summarized|omitted|updates(beta)",
      "block_binding": "beta"
     },
     {
      "type": "adaptive",
      "display": "summarized|omitted|updates(beta)",
      "block_binding": "beta"
     },
     {
      "type": "disabled"
     }
    ]
   },
   "sdk_types": {
    "python": "ThinkingConfigEnabled / ThinkingConfigAdaptive / ThinkingConfigDisabled (+Beta*)",
    "node": "ThinkingConfigParam"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/thinking",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "compaction (content block)",
   "kind": "content_block",
   "description": "Server-written summary replacing earlier context. Threshold compaction: content string (null if the summarizer called a tool), appears at the start of the assistant response. On-demand (compact-2026-09-04): signed block with signature, returned alone with stop_reason 'compaction'; must be sent first in messages on later requests. encrypted_content is opaque round-trip metadata. cache_control allowed.",
   "schema": {
    "type": "compaction",
    "content": "string | null",
    "signature": "string (on-demand beta)",
    "encrypted_content": "string | null",
    "cache_control": "CacheControlEphemeral?"
   },
   "sdk_types": {
    "python": "BetaCompactionBlock / BetaCompactionBlockParam",
    "node": "BetaCompactionBlock"
   },
   "status": [
    "DOCUMENTED",
    "BETA",
    "LIVE_VERIFIED"
   ],
   "example": {
    "type": "compaction",
    "content": "Ada introduced herself and shared that she likes the color teal…",
    "signature": "CAISzAMKHggRGALyARdjb21wYWN0aW9uX3NpZ25hdHVyZV92MRIM…"
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "compact_04 on Sonnet 5"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/compaction",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "CompactionConfig (request)",
   "kind": "request_object",
   "description": "Top-level compaction parameter (compact-2026-09-04).",
   "schema": {
    "type": "summarize",
    "instructions": "string <= 16384 | null"
   },
   "sdk_types": {
    "python": "BetaCompactionConfig"
   },
   "status": [
    "DOCUMENTED",
    "BETA",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/compaction",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "ContextManagementConfig (request)",
   "kind": "request_object",
   "description": "context_management.edits strategies.",
   "schema": {
    "edits": [
     {
      "type": "clear_tool_uses_20250919",
      "trigger": {
       "type": "input_tokens|tool_uses",
       "value": "int>=1"
      },
      "keep": {
       "type": "tool_uses",
       "value": "int>=0"
      },
      "clear_at_least": {
       "type": "input_tokens",
       "value": "int>=0"
      },
      "exclude_tools": [
       "string"
      ],
      "clear_tool_inputs": "bool | string[]"
     },
     {
      "type": "clear_thinking_20251015",
      "keep": "{type:'thinking_turns', value>=1} | {type:'all'} | 'all'"
     },
     {
      "type": "compact_20260112",
      "trigger": {
       "type": "input_tokens",
       "value": "int>=50000"
      },
      "pause_after_compaction": "bool",
      "instructions": "string|null"
     }
    ]
   },
   "sdk_types": {
    "python": "BetaContextManagementConfig, BetaClearToolUses20250919Edit, BetaClearThinking20251015Edit, BetaCompact20260112Edit, BetaInputTokensTrigger, BetaToolUsesTrigger, BetaThinkingTurns",
    "node": "same names"
   },
   "status": [
    "DOCUMENTED",
    "BETA",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/context-editing",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "context_management (response)",
   "kind": "response_field",
   "description": "Edits applied during the request (also in the final message_delta when streaming, and in count_tokens as {original_input_tokens}).",
   "schema": {
    "applied_edits": [
     {
      "type": "clear_tool_uses_20250919",
      "cleared_tool_uses": "int",
      "cleared_input_tokens": "int"
     },
     {
      "type": "clear_thinking_20251015",
      "cleared_thinking_turns": "int",
      "cleared_input_tokens": "int"
     }
    ]
   },
   "sdk_types": {
    "python": "BetaContextManagementResponse, BetaClearToolUses20250919EditResponse, BetaClearThinking20251015EditResponse"
   },
   "status": [
    "DOCUMENTED",
    "BETA",
    "LIVE_VERIFIED"
   ],
   "example": {
    "applied_edits": [
     {
      "type": "clear_tool_uses_20250919",
      "cleared_input_tokens": 174,
      "cleared_tool_uses": 2
     }
    ]
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "ctxedit_01; count_tokens -> input_tokens 838, context_management.original_input_tokens 928"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/context-editing",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "input_transformations (response)",
   "kind": "response_field",
   "description": "Beta thinking-binding-controls-2026-08-01: list of thinking blocks the API dropped or tolerated. [] when nothing happened. Streaming: on message_start (and message_delta after a mid-stream fallback).",
   "schema": {
    "input_transformations": [
     {
      "type": "thinking_dropped | thinking_mismatch_allowed",
      "path": "messages.1.content.0",
      "reason": "prefix_binding_mismatch | model_binding_mismatch"
     }
    ]
   },
   "sdk_types": {
    "python": "BetaInputTransformation"
   },
   "status": [
    "DOCUMENTED",
    "BETA",
    "LIVE_VERIFIED"
   ],
   "example": {
    "input_transformations": []
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "adaptive_07 on Sonnet 5 -> []"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/preserved-thinking",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "usage (cache & thinking fields)",
   "kind": "response_field",
   "description": "Token accounting. input_tokens = tokens after the last cache breakpoint only; total input = input + cache_read + cache_creation. cache_creation_input_tokens == sum of cache_creation.*. output_tokens_details.thinking_tokens = billed reasoning tokens (final message_delta when streaming). speed present when the fast-mode beta is active. iterations present with compaction/task-budget betas (sum for billing; compaction entries are excluded from top-level counts). inference_geo ('global' | 'not_available' | region) observed but not documented on these pages.",
   "schema": {
    "input_tokens": "int",
    "cache_creation_input_tokens": "int|null",
    "cache_read_input_tokens": "int|null",
    "cache_creation": {
     "ephemeral_5m_input_tokens": "int",
     "ephemeral_1h_input_tokens": "int"
    },
    "output_tokens": "int",
    "output_tokens_details": {
     "thinking_tokens": "int"
    },
    "server_tool_use": {
     "web_search_requests": "int"
    },
    "service_tier": "standard|priority|batch",
    "speed": "standard|fast (beta)",
    "iterations": [
     {
      "type": "message|compaction",
      "input_tokens": "int",
      "output_tokens": "int",
      "cache_read_input_tokens": "int",
      "cache_creation_input_tokens": "int",
      "cache_creation": {}
     }
    ],
    "inference_geo": "string (observed)"
   },
   "sdk_types": {
    "python": "Usage, CacheCreation, OutputTokensDetails, BetaUsage, BetaCompactionIterationUsage",
    "node": "Usage"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED",
    "LIVE_DISCOVERED"
   ],
   "example": {
    "input_tokens": 10,
    "cache_creation_input_tokens": 5809,
    "cache_read_input_tokens": 0,
    "cache_creation": {
     "ephemeral_5m_input_tokens": 5809,
     "ephemeral_1h_input_tokens": 0
    },
    "output_tokens": 5,
    "service_tier": "standard",
    "inference_geo": "not_available"
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "cache_01..08, think_01, compact_01/04, fast_04"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/prompt-caching",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "CacheControlEphemeral",
   "kind": "request_object",
   "description": "Breakpoint marker.",
   "schema": {
    "type": "ephemeral",
    "ttl": "5m|1h (optional, default 5m)"
   },
   "sdk_types": {
    "python": "CacheControlEphemeral / BetaCacheControlEphemeral"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/prompt-caching",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "OutputConfig",
   "kind": "request_object",
   "description": "output_config container.",
   "schema": {
    "effort": "low|medium|high|xhigh|max",
    "format": {
     "type": "json_schema",
     "schema": "object"
    },
    "task_budget": {
     "type": "tokens",
     "total": "int",
     "remaining": "int?"
    }
   },
   "sdk_types": {
    "python": "OutputConfig, JSONOutputFormat, BetaOutputConfig, BetaJSONOutputFormat, BetaTokenTaskBudget",
    "node": "OutputConfig, JSONOutputFormat"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/structured-outputs",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "citation: char_location",
   "kind": "citation",
   "description": "Plain-text document citation (0-indexed chars, exclusive end). From Files API text documents the citation also carries file_id and document_title null (undocumented field).",
   "schema": {
    "type": "char_location",
    "cited_text": "string (not billed)",
    "document_index": "int",
    "document_title": "string|null",
    "start_char_index": "int",
    "end_char_index": "int (exclusive)",
    "file_id": "string (observed with file sources)"
   },
   "sdk_types": {
    "python": "CitationCharLocation / CitationCharLocationParam"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED",
    "LIVE_DISCOVERED"
   ],
   "example": {
    "type": "char_location",
    "cited_text": "Grass is green.",
    "document_index": 0,
    "document_title": "Colors",
    "start_char_index": 17,
    "end_char_index": 32
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "cite_01; files_07 adds file_id"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "citation: page_location",
   "kind": "citation",
   "description": "PDF citation, 1-indexed pages, exclusive end.",
   "schema": {
    "type": "page_location",
    "cited_text": "string",
    "document_index": "int",
    "document_title": "string|null",
    "start_page_number": "int",
    "end_page_number": "int (exclusive)"
   },
   "sdk_types": {
    "python": "CitationPageLocation"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": {
    "type": "page_location",
    "cited_text": "Grass is green.",
    "document_index": 0,
    "document_title": "Colors PDF",
    "start_page_number": 1,
    "end_page_number": 2
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "cite_04 1-page generated PDF"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "citation: content_block_location",
   "kind": "citation",
   "description": "Custom-content document citation, block indices 0-indexed exclusive end.",
   "schema": {
    "type": "content_block_location",
    "cited_text": "string",
    "document_index": "int",
    "document_title": "string|null",
    "start_block_index": "int",
    "end_block_index": "int"
   },
   "sdk_types": {
    "python": "CitationContentBlockLocation"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": {
    "type": "content_block_location",
    "cited_text": "Grass is green.",
    "document_index": 0,
    "document_title": "Colors",
    "start_block_index": 1,
    "end_block_index": 2
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "cite_03"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "citation: search_result_location",
   "kind": "citation",
   "description": "Citation of a search_result block.",
   "schema": {
    "type": "search_result_location",
    "cited_text": "string",
    "source": "string",
    "title": "string|null",
    "search_result_index": "int",
    "start_block_index": "int",
    "end_block_index": "int"
   },
   "sdk_types": {
    "python": "CitationsSearchResultLocation / CitationSearchResultLocationParam"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": {
    "type": "search_result_location",
    "cited_text": "Grass is green.",
    "source": "kb://colors/1",
    "title": "Color facts",
    "search_result_index": 0,
    "start_block_index": 1,
    "end_block_index": 2
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "cite_02"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/search-results",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "citation: web_search_result_location",
   "kind": "citation",
   "description": "Citation of a web search tool result.",
   "schema": {
    "type": "web_search_result_location",
    "cited_text": "string",
    "url": "string",
    "title": "string|null",
    "encrypted_index": "string"
   },
   "sdk_types": {
    "python": "CitationsWebSearchResultLocation"
   },
   "status": [
    "DOCUMENTED"
   ],
   "example": null,
   "notes": null,
   "verification": null,
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/api/messages/create",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "CitationsConfig",
   "kind": "request_object",
   "description": "citations field on document / search_result blocks.",
   "schema": {
    "enabled": "boolean"
   },
   "sdk_types": {
    "python": "CitationsConfigParam"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "DocumentBlockParam",
   "kind": "content_block",
   "description": "Document input block.",
   "schema": {
    "type": "document",
    "source": {
     "oneOf": [
      {
       "type": "base64",
       "media_type": "application/pdf",
       "data": "base64"
      },
      {
       "type": "text",
       "media_type": "text/plain",
       "data": "string"
      },
      {
       "type": "content",
       "content": "string | [text|image blocks]"
      },
      {
       "type": "url",
       "url": "string"
      },
      {
       "type": "file",
       "file_id": "string"
      }
     ]
    },
    "title": "string?",
    "context": "string?",
    "citations": {
     "enabled": "bool"
    },
    "cache_control": "?"
   },
   "sdk_types": {
    "python": "DocumentBlockParam, Base64PDFSource, PlainTextSource, ContentBlockSource, URLPDFSource, FileDocumentSource"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/pdf-support",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "ImageBlockParam",
   "kind": "content_block",
   "description": "Image input block.",
   "schema": {
    "type": "image",
    "source": {
     "oneOf": [
      {
       "type": "base64",
       "media_type": "image/jpeg|image/png|image/gif|image/webp",
       "data": "base64"
      },
      {
       "type": "url",
       "url": "string"
      },
      {
       "type": "file",
       "file_id": "string"
      }
     ]
    },
    "transformations": {
     "oversized_image": "downsize|error"
    },
    "cache_control": "?"
   },
   "sdk_types": {
    "python": "ImageBlockParam, Base64ImageSource, URLImageSource, FileImageSource"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/vision",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "SearchResultBlockParam",
   "kind": "content_block",
   "description": "RAG search result block.",
   "schema": {
    "type": "search_result",
    "source": "string",
    "title": "string",
    "content": [
     {
      "type": "text",
      "text": "non-empty"
     }
    ],
    "citations": {
     "enabled": "bool"
    },
    "cache_control": "?"
   },
   "sdk_types": {
    "python": "SearchResultBlockParam"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/search-results",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "FileMetadata",
   "kind": "object",
   "description": "Files API object. downloadable false for uploads; expires_at null unless expires_in_seconds given (absent under the legacy beta header).",
   "schema": {
    "type": "file",
    "id": "file_…",
    "created_at": "RFC3339",
    "filename": "string 1..500",
    "mime_type": "string",
    "size_bytes": "int",
    "downloadable": "bool",
    "expires_at": "RFC3339|null"
   },
   "sdk_types": {
    "python": "FileMetadata / BetaFileMetadata",
    "node": "FileMetadata"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": {
    "type": "file",
    "id": "file_01EfVkMNzn7Yw7nQk38Rz6H2",
    "size_bytes": 607,
    "created_at": "2026-09-19T01:50:34.679190Z",
    "expires_at": "2026-09-19T02:50:34.679190Z",
    "filename": "atlas.pdf",
    "mime_type": "application/pdf",
    "downloadable": false
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "files_09"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/api/files",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "DeletedFile",
   "kind": "object",
   "description": "DELETE response.",
   "schema": {
    "id": "string",
    "type": "file_deleted"
   },
   "sdk_types": {
    "python": "DeletedFile"
   },
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": {
    "id": "file_01TqegiQ7gLB7VNsPZaqHczC",
    "type": "file_deleted"
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/api/files",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "FileList",
   "kind": "object",
   "description": "GET /v1/files response.",
   "schema": {
    "data": [
     "FileMetadata"
    ],
    "next_page": "string|null",
    "(legacy header)": {
     "has_more": "bool",
     "first_id": "string",
     "last_id": "string"
    }
   },
   "sdk_types": {},
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": ""
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/api/files",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "tool_use.caller (response)",
   "kind": "response_field",
   "description": "Observed on tool_use blocks: caller {type:'direct'} (direct call vs code_execution_20250825 / code_execution_20260120 programmatic callers per the reference).",
   "schema": {
    "caller": {
     "type": "direct | code_execution_20250825 | code_execution_20260120"
    }
   },
   "sdk_types": {},
   "status": [
    "DOCUMENTED",
    "LIVE_VERIFIED"
   ],
   "example": {
    "caller": {
     "type": "direct"
    }
   },
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "so_08"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/api/messages/create",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  },
  {
   "provider": "anthropic",
   "name": "diagnostics (response)",
   "kind": "response_field",
   "description": "Cache diagnostics beta: null when there is nothing to compare; otherwise cache_miss_reason etc.",
   "schema": {
    "diagnostics": "object | null"
   },
   "sdk_types": {},
   "status": [
    "DOCUMENTED",
    "BETA",
    "LIVE_VERIFIED"
   ],
   "example": null,
   "notes": null,
   "verification": {
    "method": "live_api",
    "verified_at": "2026-09-18",
    "result": "success",
    "http_status": 200,
    "request_note": "cache_12 -> null on first turn"
   },
   "sources": [
    {
     "url": "https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics",
     "retrieved_at": "2026-09-18"
    }
   ],
   "last_verified": "2026-09-18"
  }
 ]
}