SPB Git forge

spb/doc-api

Public
2commits 1branches 0releases
15.7 MBsize
maindefault branch
14 days agolast push
Python 88.3% TypeScript 7.6% Shell 4.1%
27.2 KB · 1,094 lines json
Raw Blame History
1{2 "domain": "anthropic-advanced",3 "generated_at": "2026-09-18",4 "records": [5  {6   "provider": "anthropic",7   "name": "thinking (content block)",8   "kind": "content_block",9   "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.",10   "schema": {11    "type": "thinking",12    "thinking": "string (summary or empty)",13    "signature": "string (opaque, long on Claude 4+)"14   },15   "sdk_types": {16    "python": "ThinkingBlock / ThinkingBlockParam / BetaThinkingBlock",17    "node": "ThinkingBlock"18   },19   "status": [20    "DOCUMENTED",21    "LIVE_VERIFIED"22   ],23   "example": {24    "type": "thinking",25    "thinking": "The user is asking for 2+2, which equals 4…",26    "signature": "EtQCCpoBCBEYAipAGx2p…"27   },28   "notes": null,29   "verification": {30    "method": "live_api",31    "verified_at": "2026-09-18",32    "result": "success",33    "http_status": 200,34    "request_note": "think_01 on Haiku"35   },36   "sources": [37    {38     "url": "https://platform.claude.com/docs/en/build-with-claude/thinking",39     "retrieved_at": "2026-09-18"40    }41   ],42   "last_verified": "2026-09-18"43  },44  {45   "provider": "anthropic",46   "name": "redacted_thinking (content block)",47   "kind": "content_block",48   "description": "Safety-redacted reasoning: encrypted data, no text. Must be round-tripped unchanged; filtering by type=='thinking' alone breaks tool-use turns.",49   "schema": {50    "type": "redacted_thinking",51    "data": "string (opaque)"52   },53   "sdk_types": {54    "python": "RedactedThinkingBlock / RedactedThinkingBlockParam",55    "node": "RedactedThinkingBlock"56   },57   "status": [58    "DOCUMENTED"59   ],60   "example": null,61   "notes": null,62   "verification": null,63   "sources": [64    {65     "url": "https://platform.claude.com/docs/en/build-with-claude/thinking",66     "retrieved_at": "2026-09-18"67    }68   ],69   "last_verified": "2026-09-18"70  },71  {72   "provider": "anthropic",73   "name": "ThinkingConfig (request)",74   "kind": "request_object",75   "description": "thinking parameter variants.",76   "schema": {77    "oneOf": [78     {79      "type": "enabled",80      "budget_tokens": "int >= 1024, < max_tokens",81      "display": "summarized|omitted|updates(beta)",82      "block_binding": "beta"83     },84     {85      "type": "adaptive",86      "display": "summarized|omitted|updates(beta)",87      "block_binding": "beta"88     },89     {90      "type": "disabled"91     }92    ]93   },94   "sdk_types": {95    "python": "ThinkingConfigEnabled / ThinkingConfigAdaptive / ThinkingConfigDisabled (+Beta*)",96    "node": "ThinkingConfigParam"97   },98   "status": [99    "DOCUMENTED",100    "LIVE_VERIFIED"101   ],102   "example": null,103   "notes": null,104   "verification": {105    "method": "live_api",106    "verified_at": "2026-09-18",107    "result": "success",108    "http_status": 200,109    "request_note": ""110   },111   "sources": [112    {113     "url": "https://platform.claude.com/docs/en/build-with-claude/thinking",114     "retrieved_at": "2026-09-18"115    }116   ],117   "last_verified": "2026-09-18"118  },119  {120   "provider": "anthropic",121   "name": "compaction (content block)",122   "kind": "content_block",123   "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.",124   "schema": {125    "type": "compaction",126    "content": "string | null",127    "signature": "string (on-demand beta)",128    "encrypted_content": "string | null",129    "cache_control": "CacheControlEphemeral?"130   },131   "sdk_types": {132    "python": "BetaCompactionBlock / BetaCompactionBlockParam",133    "node": "BetaCompactionBlock"134   },135   "status": [136    "DOCUMENTED",137    "BETA",138    "LIVE_VERIFIED"139   ],140   "example": {141    "type": "compaction",142    "content": "Ada introduced herself and shared that she likes the color teal…",143    "signature": "CAISzAMKHggRGALyARdjb21wYWN0aW9uX3NpZ25hdHVyZV92MRIM…"144   },145   "notes": null,146   "verification": {147    "method": "live_api",148    "verified_at": "2026-09-18",149    "result": "success",150    "http_status": 200,151    "request_note": "compact_04 on Sonnet 5"152   },153   "sources": [154    {155     "url": "https://platform.claude.com/docs/en/build-with-claude/compaction",156     "retrieved_at": "2026-09-18"157    }158   ],159   "last_verified": "2026-09-18"160  },161  {162   "provider": "anthropic",163   "name": "CompactionConfig (request)",164   "kind": "request_object",165   "description": "Top-level compaction parameter (compact-2026-09-04).",166   "schema": {167    "type": "summarize",168    "instructions": "string <= 16384 | null"169   },170   "sdk_types": {171    "python": "BetaCompactionConfig"172   },173   "status": [174    "DOCUMENTED",175    "BETA",176    "LIVE_VERIFIED"177   ],178   "example": null,179   "notes": null,180   "verification": {181    "method": "live_api",182    "verified_at": "2026-09-18",183    "result": "success",184    "http_status": 200,185    "request_note": ""186   },187   "sources": [188    {189     "url": "https://platform.claude.com/docs/en/build-with-claude/compaction",190     "retrieved_at": "2026-09-18"191    }192   ],193   "last_verified": "2026-09-18"194  },195  {196   "provider": "anthropic",197   "name": "ContextManagementConfig (request)",198   "kind": "request_object",199   "description": "context_management.edits strategies.",200   "schema": {201    "edits": [202     {203      "type": "clear_tool_uses_20250919",204      "trigger": {205       "type": "input_tokens|tool_uses",206       "value": "int>=1"207      },208      "keep": {209       "type": "tool_uses",210       "value": "int>=0"211      },212      "clear_at_least": {213       "type": "input_tokens",214       "value": "int>=0"215      },216      "exclude_tools": [217       "string"218      ],219      "clear_tool_inputs": "bool | string[]"220     },221     {222      "type": "clear_thinking_20251015",223      "keep": "{type:'thinking_turns', value>=1} | {type:'all'} | 'all'"224     },225     {226      "type": "compact_20260112",227      "trigger": {228       "type": "input_tokens",229       "value": "int>=50000"230      },231      "pause_after_compaction": "bool",232      "instructions": "string|null"233     }234    ]235   },236   "sdk_types": {237    "python": "BetaContextManagementConfig, BetaClearToolUses20250919Edit, BetaClearThinking20251015Edit, BetaCompact20260112Edit, BetaInputTokensTrigger, BetaToolUsesTrigger, BetaThinkingTurns",238    "node": "same names"239   },240   "status": [241    "DOCUMENTED",242    "BETA",243    "LIVE_VERIFIED"244   ],245   "example": null,246   "notes": null,247   "verification": {248    "method": "live_api",249    "verified_at": "2026-09-18",250    "result": "success",251    "http_status": 200,252    "request_note": ""253   },254   "sources": [255    {256     "url": "https://platform.claude.com/docs/en/build-with-claude/context-editing",257     "retrieved_at": "2026-09-18"258    }259   ],260   "last_verified": "2026-09-18"261  },262  {263   "provider": "anthropic",264   "name": "context_management (response)",265   "kind": "response_field",266   "description": "Edits applied during the request (also in the final message_delta when streaming, and in count_tokens as {original_input_tokens}).",267   "schema": {268    "applied_edits": [269     {270      "type": "clear_tool_uses_20250919",271      "cleared_tool_uses": "int",272      "cleared_input_tokens": "int"273     },274     {275      "type": "clear_thinking_20251015",276      "cleared_thinking_turns": "int",277      "cleared_input_tokens": "int"278     }279    ]280   },281   "sdk_types": {282    "python": "BetaContextManagementResponse, BetaClearToolUses20250919EditResponse, BetaClearThinking20251015EditResponse"283   },284   "status": [285    "DOCUMENTED",286    "BETA",287    "LIVE_VERIFIED"288   ],289   "example": {290    "applied_edits": [291     {292      "type": "clear_tool_uses_20250919",293      "cleared_input_tokens": 174,294      "cleared_tool_uses": 2295     }296    ]297   },298   "notes": null,299   "verification": {300    "method": "live_api",301    "verified_at": "2026-09-18",302    "result": "success",303    "http_status": 200,304    "request_note": "ctxedit_01; count_tokens -> input_tokens 838, context_management.original_input_tokens 928"305   },306   "sources": [307    {308     "url": "https://platform.claude.com/docs/en/build-with-claude/context-editing",309     "retrieved_at": "2026-09-18"310    }311   ],312   "last_verified": "2026-09-18"313  },314  {315   "provider": "anthropic",316   "name": "input_transformations (response)",317   "kind": "response_field",318   "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).",319   "schema": {320    "input_transformations": [321     {322      "type": "thinking_dropped | thinking_mismatch_allowed",323      "path": "messages.1.content.0",324      "reason": "prefix_binding_mismatch | model_binding_mismatch"325     }326    ]327   },328   "sdk_types": {329    "python": "BetaInputTransformation"330   },331   "status": [332    "DOCUMENTED",333    "BETA",334    "LIVE_VERIFIED"335   ],336   "example": {337    "input_transformations": []338   },339   "notes": null,340   "verification": {341    "method": "live_api",342    "verified_at": "2026-09-18",343    "result": "success",344    "http_status": 200,345    "request_note": "adaptive_07 on Sonnet 5 -> []"346   },347   "sources": [348    {349     "url": "https://platform.claude.com/docs/en/build-with-claude/preserved-thinking",350     "retrieved_at": "2026-09-18"351    }352   ],353   "last_verified": "2026-09-18"354  },355  {356   "provider": "anthropic",357   "name": "usage (cache & thinking fields)",358   "kind": "response_field",359   "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.",360   "schema": {361    "input_tokens": "int",362    "cache_creation_input_tokens": "int|null",363    "cache_read_input_tokens": "int|null",364    "cache_creation": {365     "ephemeral_5m_input_tokens": "int",366     "ephemeral_1h_input_tokens": "int"367    },368    "output_tokens": "int",369    "output_tokens_details": {370     "thinking_tokens": "int"371    },372    "server_tool_use": {373     "web_search_requests": "int"374    },375    "service_tier": "standard|priority|batch",376    "speed": "standard|fast (beta)",377    "iterations": [378     {379      "type": "message|compaction",380      "input_tokens": "int",381      "output_tokens": "int",382      "cache_read_input_tokens": "int",383      "cache_creation_input_tokens": "int",384      "cache_creation": {}385     }386    ],387    "inference_geo": "string (observed)"388   },389   "sdk_types": {390    "python": "Usage, CacheCreation, OutputTokensDetails, BetaUsage, BetaCompactionIterationUsage",391    "node": "Usage"392   },393   "status": [394    "DOCUMENTED",395    "LIVE_VERIFIED",396    "LIVE_DISCOVERED"397   ],398   "example": {399    "input_tokens": 10,400    "cache_creation_input_tokens": 5809,401    "cache_read_input_tokens": 0,402    "cache_creation": {403     "ephemeral_5m_input_tokens": 5809,404     "ephemeral_1h_input_tokens": 0405    },406    "output_tokens": 5,407    "service_tier": "standard",408    "inference_geo": "not_available"409   },410   "notes": null,411   "verification": {412    "method": "live_api",413    "verified_at": "2026-09-18",414    "result": "success",415    "http_status": 200,416    "request_note": "cache_01..08, think_01, compact_01/04, fast_04"417   },418   "sources": [419    {420     "url": "https://platform.claude.com/docs/en/build-with-claude/prompt-caching",421     "retrieved_at": "2026-09-18"422    }423   ],424   "last_verified": "2026-09-18"425  },426  {427   "provider": "anthropic",428   "name": "CacheControlEphemeral",429   "kind": "request_object",430   "description": "Breakpoint marker.",431   "schema": {432    "type": "ephemeral",433    "ttl": "5m|1h (optional, default 5m)"434   },435   "sdk_types": {436    "python": "CacheControlEphemeral / BetaCacheControlEphemeral"437   },438   "status": [439    "DOCUMENTED",440    "LIVE_VERIFIED"441   ],442   "example": null,443   "notes": null,444   "verification": {445    "method": "live_api",446    "verified_at": "2026-09-18",447    "result": "success",448    "http_status": 200,449    "request_note": ""450   },451   "sources": [452    {453     "url": "https://platform.claude.com/docs/en/build-with-claude/prompt-caching",454     "retrieved_at": "2026-09-18"455    }456   ],457   "last_verified": "2026-09-18"458  },459  {460   "provider": "anthropic",461   "name": "OutputConfig",462   "kind": "request_object",463   "description": "output_config container.",464   "schema": {465    "effort": "low|medium|high|xhigh|max",466    "format": {467     "type": "json_schema",468     "schema": "object"469    },470    "task_budget": {471     "type": "tokens",472     "total": "int",473     "remaining": "int?"474    }475   },476   "sdk_types": {477    "python": "OutputConfig, JSONOutputFormat, BetaOutputConfig, BetaJSONOutputFormat, BetaTokenTaskBudget",478    "node": "OutputConfig, JSONOutputFormat"479   },480   "status": [481    "DOCUMENTED",482    "LIVE_VERIFIED"483   ],484   "example": null,485   "notes": null,486   "verification": {487    "method": "live_api",488    "verified_at": "2026-09-18",489    "result": "success",490    "http_status": 200,491    "request_note": ""492   },493   "sources": [494    {495     "url": "https://platform.claude.com/docs/en/build-with-claude/structured-outputs",496     "retrieved_at": "2026-09-18"497    }498   ],499   "last_verified": "2026-09-18"500  },501  {502   "provider": "anthropic",503   "name": "citation: char_location",504   "kind": "citation",505   "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).",506   "schema": {507    "type": "char_location",508    "cited_text": "string (not billed)",509    "document_index": "int",510    "document_title": "string|null",511    "start_char_index": "int",512    "end_char_index": "int (exclusive)",513    "file_id": "string (observed with file sources)"514   },515   "sdk_types": {516    "python": "CitationCharLocation / CitationCharLocationParam"517   },518   "status": [519    "DOCUMENTED",520    "LIVE_VERIFIED",521    "LIVE_DISCOVERED"522   ],523   "example": {524    "type": "char_location",525    "cited_text": "Grass is green.",526    "document_index": 0,527    "document_title": "Colors",528    "start_char_index": 17,529    "end_char_index": 32530   },531   "notes": null,532   "verification": {533    "method": "live_api",534    "verified_at": "2026-09-18",535    "result": "success",536    "http_status": 200,537    "request_note": "cite_01; files_07 adds file_id"538   },539   "sources": [540    {541     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",542     "retrieved_at": "2026-09-18"543    }544   ],545   "last_verified": "2026-09-18"546  },547  {548   "provider": "anthropic",549   "name": "citation: page_location",550   "kind": "citation",551   "description": "PDF citation, 1-indexed pages, exclusive end.",552   "schema": {553    "type": "page_location",554    "cited_text": "string",555    "document_index": "int",556    "document_title": "string|null",557    "start_page_number": "int",558    "end_page_number": "int (exclusive)"559   },560   "sdk_types": {561    "python": "CitationPageLocation"562   },563   "status": [564    "DOCUMENTED",565    "LIVE_VERIFIED"566   ],567   "example": {568    "type": "page_location",569    "cited_text": "Grass is green.",570    "document_index": 0,571    "document_title": "Colors PDF",572    "start_page_number": 1,573    "end_page_number": 2574   },575   "notes": null,576   "verification": {577    "method": "live_api",578    "verified_at": "2026-09-18",579    "result": "success",580    "http_status": 200,581    "request_note": "cite_04 1-page generated PDF"582   },583   "sources": [584    {585     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",586     "retrieved_at": "2026-09-18"587    }588   ],589   "last_verified": "2026-09-18"590  },591  {592   "provider": "anthropic",593   "name": "citation: content_block_location",594   "kind": "citation",595   "description": "Custom-content document citation, block indices 0-indexed exclusive end.",596   "schema": {597    "type": "content_block_location",598    "cited_text": "string",599    "document_index": "int",600    "document_title": "string|null",601    "start_block_index": "int",602    "end_block_index": "int"603   },604   "sdk_types": {605    "python": "CitationContentBlockLocation"606   },607   "status": [608    "DOCUMENTED",609    "LIVE_VERIFIED"610   ],611   "example": {612    "type": "content_block_location",613    "cited_text": "Grass is green.",614    "document_index": 0,615    "document_title": "Colors",616    "start_block_index": 1,617    "end_block_index": 2618   },619   "notes": null,620   "verification": {621    "method": "live_api",622    "verified_at": "2026-09-18",623    "result": "success",624    "http_status": 200,625    "request_note": "cite_03"626   },627   "sources": [628    {629     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",630     "retrieved_at": "2026-09-18"631    }632   ],633   "last_verified": "2026-09-18"634  },635  {636   "provider": "anthropic",637   "name": "citation: search_result_location",638   "kind": "citation",639   "description": "Citation of a search_result block.",640   "schema": {641    "type": "search_result_location",642    "cited_text": "string",643    "source": "string",644    "title": "string|null",645    "search_result_index": "int",646    "start_block_index": "int",647    "end_block_index": "int"648   },649   "sdk_types": {650    "python": "CitationsSearchResultLocation / CitationSearchResultLocationParam"651   },652   "status": [653    "DOCUMENTED",654    "LIVE_VERIFIED"655   ],656   "example": {657    "type": "search_result_location",658    "cited_text": "Grass is green.",659    "source": "kb://colors/1",660    "title": "Color facts",661    "search_result_index": 0,662    "start_block_index": 1,663    "end_block_index": 2664   },665   "notes": null,666   "verification": {667    "method": "live_api",668    "verified_at": "2026-09-18",669    "result": "success",670    "http_status": 200,671    "request_note": "cite_02"672   },673   "sources": [674    {675     "url": "https://platform.claude.com/docs/en/build-with-claude/search-results",676     "retrieved_at": "2026-09-18"677    }678   ],679   "last_verified": "2026-09-18"680  },681  {682   "provider": "anthropic",683   "name": "citation: web_search_result_location",684   "kind": "citation",685   "description": "Citation of a web search tool result.",686   "schema": {687    "type": "web_search_result_location",688    "cited_text": "string",689    "url": "string",690    "title": "string|null",691    "encrypted_index": "string"692   },693   "sdk_types": {694    "python": "CitationsWebSearchResultLocation"695   },696   "status": [697    "DOCUMENTED"698   ],699   "example": null,700   "notes": null,701   "verification": null,702   "sources": [703    {704     "url": "https://platform.claude.com/docs/en/api/messages/create",705     "retrieved_at": "2026-09-18"706    }707   ],708   "last_verified": "2026-09-18"709  },710  {711   "provider": "anthropic",712   "name": "CitationsConfig",713   "kind": "request_object",714   "description": "citations field on document / search_result blocks.",715   "schema": {716    "enabled": "boolean"717   },718   "sdk_types": {719    "python": "CitationsConfigParam"720   },721   "status": [722    "DOCUMENTED",723    "LIVE_VERIFIED"724   ],725   "example": null,726   "notes": null,727   "verification": {728    "method": "live_api",729    "verified_at": "2026-09-18",730    "result": "success",731    "http_status": 200,732    "request_note": ""733   },734   "sources": [735    {736     "url": "https://platform.claude.com/docs/en/build-with-claude/citations",737     "retrieved_at": "2026-09-18"738    }739   ],740   "last_verified": "2026-09-18"741  },742  {743   "provider": "anthropic",744   "name": "DocumentBlockParam",745   "kind": "content_block",746   "description": "Document input block.",747   "schema": {748    "type": "document",749    "source": {750     "oneOf": [751      {752       "type": "base64",753       "media_type": "application/pdf",754       "data": "base64"755      },756      {757       "type": "text",758       "media_type": "text/plain",759       "data": "string"760      },761      {762       "type": "content",763       "content": "string | [text|image blocks]"764      },765      {766       "type": "url",767       "url": "string"768      },769      {770       "type": "file",771       "file_id": "string"772      }773     ]774    },775    "title": "string?",776    "context": "string?",777    "citations": {778     "enabled": "bool"779    },780    "cache_control": "?"781   },782   "sdk_types": {783    "python": "DocumentBlockParam, Base64PDFSource, PlainTextSource, ContentBlockSource, URLPDFSource, FileDocumentSource"784   },785   "status": [786    "DOCUMENTED",787    "LIVE_VERIFIED"788   ],789   "example": null,790   "notes": null,791   "verification": {792    "method": "live_api",793    "verified_at": "2026-09-18",794    "result": "success",795    "http_status": 200,796    "request_note": ""797   },798   "sources": [799    {800     "url": "https://platform.claude.com/docs/en/build-with-claude/pdf-support",801     "retrieved_at": "2026-09-18"802    }803   ],804   "last_verified": "2026-09-18"805  },806  {807   "provider": "anthropic",808   "name": "ImageBlockParam",809   "kind": "content_block",810   "description": "Image input block.",811   "schema": {812    "type": "image",813    "source": {814     "oneOf": [815      {816       "type": "base64",817       "media_type": "image/jpeg|image/png|image/gif|image/webp",818       "data": "base64"819      },820      {821       "type": "url",822       "url": "string"823      },824      {825       "type": "file",826       "file_id": "string"827      }828     ]829    },830    "transformations": {831     "oversized_image": "downsize|error"832    },833    "cache_control": "?"834   },835   "sdk_types": {836    "python": "ImageBlockParam, Base64ImageSource, URLImageSource, FileImageSource"837   },838   "status": [839    "DOCUMENTED",840    "LIVE_VERIFIED"841   ],842   "example": null,843   "notes": null,844   "verification": {845    "method": "live_api",846    "verified_at": "2026-09-18",847    "result": "success",848    "http_status": 200,849    "request_note": ""850   },851   "sources": [852    {853     "url": "https://platform.claude.com/docs/en/build-with-claude/vision",854     "retrieved_at": "2026-09-18"855    }856   ],857   "last_verified": "2026-09-18"858  },859  {860   "provider": "anthropic",861   "name": "SearchResultBlockParam",862   "kind": "content_block",863   "description": "RAG search result block.",864   "schema": {865    "type": "search_result",866    "source": "string",867    "title": "string",868    "content": [869     {870      "type": "text",871      "text": "non-empty"872     }873    ],874    "citations": {875     "enabled": "bool"876    },877    "cache_control": "?"878   },879   "sdk_types": {880    "python": "SearchResultBlockParam"881   },882   "status": [883    "DOCUMENTED",884    "LIVE_VERIFIED"885   ],886   "example": null,887   "notes": null,888   "verification": {889    "method": "live_api",890    "verified_at": "2026-09-18",891    "result": "success",892    "http_status": 200,893    "request_note": ""894   },895   "sources": [896    {897     "url": "https://platform.claude.com/docs/en/build-with-claude/search-results",898     "retrieved_at": "2026-09-18"899    }900   ],901   "last_verified": "2026-09-18"902  },903  {904   "provider": "anthropic",905   "name": "FileMetadata",906   "kind": "object",907   "description": "Files API object. downloadable false for uploads; expires_at null unless expires_in_seconds given (absent under the legacy beta header).",908   "schema": {909    "type": "file",910    "id": "file_…",911    "created_at": "RFC3339",912    "filename": "string 1..500",913    "mime_type": "string",914    "size_bytes": "int",915    "downloadable": "bool",916    "expires_at": "RFC3339|null"917   },918   "sdk_types": {919    "python": "FileMetadata / BetaFileMetadata",920    "node": "FileMetadata"921   },922   "status": [923    "DOCUMENTED",924    "LIVE_VERIFIED"925   ],926   "example": {927    "type": "file",928    "id": "file_01EfVkMNzn7Yw7nQk38Rz6H2",929    "size_bytes": 607,930    "created_at": "2026-09-19T01:50:34.679190Z",931    "expires_at": "2026-09-19T02:50:34.679190Z",932    "filename": "atlas.pdf",933    "mime_type": "application/pdf",934    "downloadable": false935   },936   "notes": null,937   "verification": {938    "method": "live_api",939    "verified_at": "2026-09-18",940    "result": "success",941    "http_status": 200,942    "request_note": "files_09"943   },944   "sources": [945    {946     "url": "https://platform.claude.com/docs/en/api/files",947     "retrieved_at": "2026-09-18"948    }949   ],950   "last_verified": "2026-09-18"951  },952  {953   "provider": "anthropic",954   "name": "DeletedFile",955   "kind": "object",956   "description": "DELETE response.",957   "schema": {958    "id": "string",959    "type": "file_deleted"960   },961   "sdk_types": {962    "python": "DeletedFile"963   },964   "status": [965    "DOCUMENTED",966    "LIVE_VERIFIED"967   ],968   "example": {969    "id": "file_01TqegiQ7gLB7VNsPZaqHczC",970    "type": "file_deleted"971   },972   "notes": null,973   "verification": {974    "method": "live_api",975    "verified_at": "2026-09-18",976    "result": "success",977    "http_status": 200,978    "request_note": ""979   },980   "sources": [981    {982     "url": "https://platform.claude.com/docs/en/api/files",983     "retrieved_at": "2026-09-18"984    }985   ],986   "last_verified": "2026-09-18"987  },988  {989   "provider": "anthropic",990   "name": "FileList",991   "kind": "object",992   "description": "GET /v1/files response.",993   "schema": {994    "data": [995     "FileMetadata"996    ],997    "next_page": "string|null",998    "(legacy header)": {999     "has_more": "bool",1000     "first_id": "string",1001     "last_id": "string"1002    }1003   },1004   "sdk_types": {},1005   "status": [1006    "DOCUMENTED",1007    "LIVE_VERIFIED"1008   ],1009   "example": null,1010   "notes": null,1011   "verification": {1012    "method": "live_api",1013    "verified_at": "2026-09-18",1014    "result": "success",1015    "http_status": 200,1016    "request_note": ""1017   },1018   "sources": [1019    {1020     "url": "https://platform.claude.com/docs/en/api/files",1021     "retrieved_at": "2026-09-18"1022    }1023   ],1024   "last_verified": "2026-09-18"1025  },1026  {1027   "provider": "anthropic",1028   "name": "tool_use.caller (response)",1029   "kind": "response_field",1030   "description": "Observed on tool_use blocks: caller {type:'direct'} (direct call vs code_execution_20250825 / code_execution_20260120 programmatic callers per the reference).",1031   "schema": {1032    "caller": {1033     "type": "direct | code_execution_20250825 | code_execution_20260120"1034    }1035   },1036   "sdk_types": {},1037   "status": [1038    "DOCUMENTED",1039    "LIVE_VERIFIED"1040   ],1041   "example": {1042    "caller": {1043     "type": "direct"1044    }1045   },1046   "notes": null,1047   "verification": {1048    "method": "live_api",1049    "verified_at": "2026-09-18",1050    "result": "success",1051    "http_status": 200,1052    "request_note": "so_08"1053   },1054   "sources": [1055    {1056     "url": "https://platform.claude.com/docs/en/api/messages/create",1057     "retrieved_at": "2026-09-18"1058    }1059   ],1060   "last_verified": "2026-09-18"1061  },1062  {1063   "provider": "anthropic",1064   "name": "diagnostics (response)",1065   "kind": "response_field",1066   "description": "Cache diagnostics beta: null when there is nothing to compare; otherwise cache_miss_reason etc.",1067   "schema": {1068    "diagnostics": "object | null"1069   },1070   "sdk_types": {},1071   "status": [1072    "DOCUMENTED",1073    "BETA",1074    "LIVE_VERIFIED"1075   ],1076   "example": null,1077   "notes": null,1078   "verification": {1079    "method": "live_api",1080    "verified_at": "2026-09-18",1081    "result": "success",1082    "http_status": 200,1083    "request_note": "cache_12 -> null on first turn"1084   },1085   "sources": [1086    {1087     "url": "https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics",1088     "retrieved_at": "2026-09-18"1089    }1090   ],1091   "last_verified": "2026-09-18"1092  }1093 ]1094}