Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    Using the API
    API overviewBeta headersErrors
    Messages
    Create a Message
    Count tokens in a Message
    Models
    List Models
    Get a Model
    Beta
    Admin
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    Messages

    Create a Message
    Message Messages.Create(MessageCreateParamsparameters, CancellationTokencancellationToken = default)
    POST/v1/messages
    Count tokens in a Message
    MessageTokensCount Messages.CountTokens(MessageCountTokensParamsparameters, CancellationTokencancellationToken = default)
    POST/v1/messages/count_tokens
    ModelsExpand Collapse
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class Base64PdfSource:
    required string Data
    JsonElement MediaType "application/pdf"constant
    JsonElement Type "base64"constant
    class BashCodeExecutionOutputBlock:
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    class BashCodeExecutionOutputBlockParam:
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    class BashCodeExecutionResultBlock:
    required IReadOnlyList<BashCodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "bash_code_execution_result"constant
    class BashCodeExecutionResultBlockParam:
    required IReadOnlyList<BashCodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "bash_code_execution_result"constant
    class BashCodeExecutionToolResultBlock:
    required Content Content
    Accepts one of the following:
    class BashCodeExecutionToolResultError:
    required BashCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "output_file_too_large"OutputFileTooLarge
    JsonElement Type "bash_code_execution_tool_result_error"constant
    class BashCodeExecutionResultBlock:
    required IReadOnlyList<BashCodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "bash_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "bash_code_execution_tool_result"constant
    class BashCodeExecutionToolResultBlockParam:
    required Content Content
    Accepts one of the following:
    class BashCodeExecutionToolResultErrorParam:
    required BashCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "output_file_too_large"OutputFileTooLarge
    JsonElement Type "bash_code_execution_tool_result_error"constant
    class BashCodeExecutionResultBlockParam:
    required IReadOnlyList<BashCodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "bash_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "bash_code_execution_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class BashCodeExecutionToolResultError:
    required BashCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "output_file_too_large"OutputFileTooLarge
    JsonElement Type "bash_code_execution_tool_result_error"constant
    enum BashCodeExecutionToolResultErrorCode:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "output_file_too_large"OutputFileTooLarge
    class BashCodeExecutionToolResultErrorParam:
    required BashCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "output_file_too_large"OutputFileTooLarge
    JsonElement Type "bash_code_execution_tool_result_error"constant
    class CacheControlEphemeral:
    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class CacheCreation:
    required Long Ephemeral1hInputTokens

    The number of input tokens used to create the 1 hour cache entry.

    required Long Ephemeral5mInputTokens

    The number of input tokens used to create the 5 minute cache entry.

    class CitationCharLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required string? FileID
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationContentBlockLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required string? FileID
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationPageLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required string? FileID
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationsConfig:
    required Boolean Enabled
    class CitationsConfigParam:
    Boolean Enabled
    class CitationsDelta:
    required Citation Citation
    Accepts one of the following:
    class CitationCharLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required string? FileID
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required string? FileID
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required string? FileID
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationsWebSearchResultLocation:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationsSearchResultLocation:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    JsonElement Type "citations_delta"constant
    class CitationsSearchResultLocation:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class CitationsWebSearchResultLocation:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CodeExecutionOutputBlock:
    required string FileID
    JsonElement Type "code_execution_output"constant
    class CodeExecutionOutputBlockParam:
    required string FileID
    JsonElement Type "code_execution_output"constant
    class CodeExecutionResultBlock:
    required IReadOnlyList<CodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class CodeExecutionResultBlockParam:
    required IReadOnlyList<CodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class CodeExecutionTool20250522:
    JsonElement Name "code_execution"constant

    Name of the tool.

    This is how the tool will be called by the model and in tool_use blocks.

    JsonElement Type "code_execution_20250522"constant
    IReadOnlyList<AllowedCaller> AllowedCallers
    Accepts one of the following:
    "direct"Direct
    "code_execution_20250825"CodeExecution20250825
    "code_execution_20260120"CodeExecution20260120
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Boolean DeferLoading

    If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.

    Boolean Strict

    When true, guarantees schema validation on tool names and inputs

    class CodeExecutionTool20250825:
    JsonElement Name "code_execution"constant

    Name of the tool.

    This is how the tool will be called by the model and in tool_use blocks.

    JsonElement Type "code_execution_20250825"constant
    IReadOnlyList<AllowedCaller> AllowedCallers
    Accepts one of the following:
    "direct"Direct
    "code_execution_20250825"CodeExecution20250825
    "code_execution_20260120"CodeExecution20260120
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Boolean DeferLoading

    If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.

    Boolean Strict

    When true, guarantees schema validation on tool names and inputs

    class CodeExecutionTool20260120:

    Code execution tool with REPL state persistence (daemon mode + gVisor checkpoint).

    JsonElement Name "code_execution"constant

    Name of the tool.

    This is how the tool will be called by the model and in tool_use blocks.

    JsonElement Type "code_execution_20260120"constant
    IReadOnlyList<AllowedCaller> AllowedCallers
    Accepts one of the following:
    "direct"Direct
    "code_execution_20250825"CodeExecution20250825
    "code_execution_20260120"CodeExecution20260120
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Boolean DeferLoading

    If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.

    Boolean Strict

    When true, guarantees schema validation on tool names and inputs

    class CodeExecutionToolResultBlock:
    required CodeExecutionToolResultBlockContent Content

    Code execution result with encrypted stdout for PFC + web_search results.

    Accepts one of the following:
    class CodeExecutionToolResultError:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    class CodeExecutionResultBlock:
    required IReadOnlyList<CodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class EncryptedCodeExecutionResultBlock:

    Code execution result with encrypted stdout for PFC + web_search results.

    required IReadOnlyList<CodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required string EncryptedStdout
    required Long ReturnCode
    required string Stderr
    JsonElement Type "encrypted_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "code_execution_tool_result"constant
    class CodeExecutionToolResultBlockContent: A class that can be one of several variants.union

    Code execution result with encrypted stdout for PFC + web_search results.

    class CodeExecutionToolResultError:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    class CodeExecutionResultBlock:
    required IReadOnlyList<CodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class EncryptedCodeExecutionResultBlock:

    Code execution result with encrypted stdout for PFC + web_search results.

    required IReadOnlyList<CodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required string EncryptedStdout
    required Long ReturnCode
    required string Stderr
    JsonElement Type "encrypted_code_execution_result"constant
    class CodeExecutionToolResultBlockParam:
    required CodeExecutionToolResultBlockParamContent Content

    Code execution result with encrypted stdout for PFC + web_search results.

    Accepts one of the following:
    class CodeExecutionToolResultErrorParam:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    class CodeExecutionResultBlockParam:
    required IReadOnlyList<CodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class EncryptedCodeExecutionResultBlockParam:

    Code execution result with encrypted stdout for PFC + web_search results.

    required IReadOnlyList<CodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required string EncryptedStdout
    required Long ReturnCode
    required string Stderr
    JsonElement Type "encrypted_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "code_execution_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class CodeExecutionToolResultBlockParamContent: A class that can be one of several variants.union

    Code execution result with encrypted stdout for PFC + web_search results.

    class CodeExecutionToolResultErrorParam:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    class CodeExecutionResultBlockParam:
    required IReadOnlyList<CodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class EncryptedCodeExecutionResultBlockParam:

    Code execution result with encrypted stdout for PFC + web_search results.

    required IReadOnlyList<CodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required string EncryptedStdout
    required Long ReturnCode
    required string Stderr
    JsonElement Type "encrypted_code_execution_result"constant
    class CodeExecutionToolResultError:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    enum CodeExecutionToolResultErrorCode:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    class CodeExecutionToolResultErrorParam:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    class Container:

    Information about the container used in the request (for the code execution tool)

    required string ID

    Identifier for the container used in this request

    required DateTimeOffset ExpiresAt

    The time at which the container will expire.

    class ContainerUploadBlock:

    Response model for a file uploaded to the container.

    required string FileID
    JsonElement Type "container_upload"constant
    class ContainerUploadBlockParam:

    A content block that represents a file to be uploaded to the container Files uploaded via this block will be available in the container's input directory.

    required string FileID
    JsonElement Type "container_upload"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class ContentBlock: A class that can be one of several variants.union

    Response model for a file uploaded to the container.

    class TextBlock:
    required IReadOnlyList<TextCitation>? Citations

    Citations supporting the text block.

    The type of citation returned will depend on the type of document being cited. Citing a PDF results in page_location, plain text results in char_location, and content document results in content_block_location.

    Accepts one of the following:
    class CitationCharLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required string? FileID
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required string? FileID
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocation:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required string? FileID
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationsWebSearchResultLocation:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationsSearchResultLocation:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    required string Text
    JsonElement Type "text"constant
    class ThinkingBlock:
    required string Signature
    required string Thinking
    JsonElement Type "thinking"constant
    class RedactedThinkingBlock:
    required string Data
    JsonElement Type "redacted_thinking"constant
    class ToolUseBlock:
    required string ID
    required Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    required IReadOnlyDictionary<string, JsonElement> Input
    required string Name
    JsonElement Type "tool_use"constant
    class ServerToolUseBlock:
    required string ID
    required Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    required IReadOnlyDictionary<string, JsonElement> Input
    required Name Name
    Accepts one of the following:
    "web_search"WebSearch
    "web_fetch"WebFetch
    "code_execution"CodeExecution
    "bash_code_execution"BashCodeExecution
    "text_editor_code_execution"TextEditorCodeExecution
    "tool_search_tool_regex"ToolSearchToolRegex
    "tool_search_tool_bm25"ToolSearchToolBm25
    JsonElement Type "server_tool_use"constant
    class WebSearchToolResultBlock:
    required Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    required WebSearchToolResultBlockContent Content
    Accepts one of the following:
    class WebSearchToolResultError:
    required WebSearchToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "max_uses_exceeded"MaxUsesExceeded
    "too_many_requests"TooManyRequests
    "query_too_long"QueryTooLong
    "request_too_large"RequestTooLarge
    JsonElement Type "web_search_tool_result_error"constant
    IReadOnlyList<WebSearchResultBlock>
    required string EncryptedContent
    required string? PageAge
    required string Title
    JsonElement Type "web_search_result"constant
    required string Url
    required string ToolUseID
    JsonElement Type "web_search_tool_result"constant
    class WebFetchToolResultBlock:
    required Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    required Content Content
    Accepts one of the following:
    class WebFetchToolResultErrorBlock:
    required WebFetchToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "url_too_long"UrlTooLong
    "url_not_allowed"UrlNotAllowed
    "url_not_accessible"UrlNotAccessible
    "unsupported_content_type"UnsupportedContentType
    "too_many_requests"TooManyRequests
    "max_uses_exceeded"MaxUsesExceeded
    "unavailable"Unavailable
    JsonElement Type "web_fetch_tool_result_error"constant
    class WebFetchBlock:
    required DocumentBlock Content
    required CitationsConfig? Citations

    Citation configuration for the document

    required Boolean Enabled
    required Source Source
    Accepts one of the following:
    class Base64PdfSource:
    required string Data
    JsonElement MediaType "application/pdf"constant
    JsonElement Type "base64"constant
    class PlainTextSource:
    required string Data
    JsonElement MediaType "text/plain"constant
    JsonElement Type "text"constant
    required string? Title

    The title of the document

    JsonElement Type "document"constant
    required string? RetrievedAt

    ISO 8601 timestamp when the content was retrieved

    JsonElement Type "web_fetch_result"constant
    required string Url

    Fetched content URL

    required string ToolUseID
    JsonElement Type "web_fetch_tool_result"constant
    class CodeExecutionToolResultBlock:
    required CodeExecutionToolResultBlockContent Content

    Code execution result with encrypted stdout for PFC + web_search results.

    Accepts one of the following:
    class CodeExecutionToolResultError:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    class CodeExecutionResultBlock:
    required IReadOnlyList<CodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class EncryptedCodeExecutionResultBlock:

    Code execution result with encrypted stdout for PFC + web_search results.

    required IReadOnlyList<CodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required string EncryptedStdout
    required Long ReturnCode
    required string Stderr
    JsonElement Type "encrypted_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "code_execution_tool_result"constant
    class BashCodeExecutionToolResultBlock:
    required Content Content
    Accepts one of the following:
    class BashCodeExecutionToolResultError:
    required BashCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "output_file_too_large"OutputFileTooLarge
    JsonElement Type "bash_code_execution_tool_result_error"constant
    class BashCodeExecutionResultBlock:
    required IReadOnlyList<BashCodeExecutionOutputBlock> Content
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "bash_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "bash_code_execution_tool_result"constant
    class TextEditorCodeExecutionToolResultBlock:
    required Content Content
    Accepts one of the following:
    class TextEditorCodeExecutionToolResultError:
    required TextEditorCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "file_not_found"FileNotFound
    required string? ErrorMessage
    JsonElement Type "text_editor_code_execution_tool_result_error"constant
    class TextEditorCodeExecutionViewResultBlock:
    required string Content
    required FileType FileType
    Accepts one of the following:
    "text"Text
    "image"Image
    "pdf"Pdf
    required Long? NumLines
    required Long? StartLine
    required Long? TotalLines
    JsonElement Type "text_editor_code_execution_view_result"constant
    class TextEditorCodeExecutionCreateResultBlock:
    required Boolean IsFileUpdate
    JsonElement Type "text_editor_code_execution_create_result"constant
    class TextEditorCodeExecutionStrReplaceResultBlock:
    required IReadOnlyList<string>? Lines
    required Long? NewLines
    required Long? NewStart
    required Long? OldLines
    required Long? OldStart
    JsonElement Type "text_editor_code_execution_str_replace_result"constant
    required string ToolUseID
    JsonElement Type "text_editor_code_execution_tool_result"constant
    class ToolSearchToolResultBlock:
    required Content Content
    Accepts one of the following:
    class ToolSearchToolResultError:
    required ToolSearchToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    required string? ErrorMessage
    JsonElement Type "tool_search_tool_result_error"constant
    class ToolSearchToolSearchResultBlock:
    required IReadOnlyList<ToolReferenceBlock> ToolReferences
    required string ToolName
    JsonElement Type "tool_reference"constant
    JsonElement Type "tool_search_tool_search_result"constant
    required string ToolUseID
    JsonElement Type "tool_search_tool_result"constant
    class ContainerUploadBlock:

    Response model for a file uploaded to the container.

    required string FileID
    JsonElement Type "container_upload"constant
    class ContentBlockParam: A class that can be one of several variants.union

    Regular text content.

    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class DocumentBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64PdfSource:
    required string Data
    JsonElement MediaType "application/pdf"constant
    JsonElement Type "base64"constant
    class PlainTextSource:
    required string Data
    JsonElement MediaType "text/plain"constant
    JsonElement Type "text"constant
    class ContentBlockSource:
    required Content Content
    Accepts one of the following:
    string
    IReadOnlyList<ContentBlockSourceContent>
    Accepts one of the following:
    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    JsonElement Type "content"constant
    class UrlPdfSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "document"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    CitationsConfigParam? Citations
    Boolean Enabled
    string? Context
    string? Title
    class SearchResultBlockParam:
    required IReadOnlyList<TextBlockParam> Content
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    required string Source
    required string Title
    JsonElement Type "search_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    CitationsConfigParam Citations
    Boolean Enabled
    class ThinkingBlockParam:
    required string Signature
    required string Thinking
    JsonElement Type "thinking"constant
    class RedactedThinkingBlockParam:
    required string Data
    JsonElement Type "redacted_thinking"constant
    class ToolUseBlockParam:
    required string ID
    required IReadOnlyDictionary<string, JsonElement> Input
    required string Name
    JsonElement Type "tool_use"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    class ToolResultBlockParam:
    required string ToolUseID
    JsonElement Type "tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Content Content
    Accepts one of the following:
    string
    IReadOnlyList<Block>
    Accepts one of the following:
    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class SearchResultBlockParam:
    required IReadOnlyList<TextBlockParam> Content
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    required string Source
    required string Title
    JsonElement Type "search_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    CitationsConfigParam Citations
    Boolean Enabled
    class DocumentBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64PdfSource:
    required string Data
    JsonElement MediaType "application/pdf"constant
    JsonElement Type "base64"constant
    class PlainTextSource:
    required string Data
    JsonElement MediaType "text/plain"constant
    JsonElement Type "text"constant
    class ContentBlockSource:
    required Content Content
    Accepts one of the following:
    string
    IReadOnlyList<ContentBlockSourceContent>
    Accepts one of the following:
    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    JsonElement Type "content"constant
    class UrlPdfSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "document"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    CitationsConfigParam? Citations
    Boolean Enabled
    string? Context
    string? Title
    class ToolReferenceBlockParam:

    Tool reference block that can be included in tool_result content.

    required string ToolName
    JsonElement Type "tool_reference"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Boolean IsError
    class ServerToolUseBlockParam:
    required string ID
    required IReadOnlyDictionary<string, JsonElement> Input
    required Name Name
    Accepts one of the following:
    "web_search"WebSearch
    "web_fetch"WebFetch
    "code_execution"CodeExecution
    "bash_code_execution"BashCodeExecution
    "text_editor_code_execution"TextEditorCodeExecution
    "tool_search_tool_regex"ToolSearchToolRegex
    "tool_search_tool_bm25"ToolSearchToolBm25
    JsonElement Type "server_tool_use"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    class WebSearchToolResultBlockParam:
    required WebSearchToolResultBlockParamContent Content
    Accepts one of the following:
    IReadOnlyList<WebSearchResultBlockParam>
    required string EncryptedContent
    required string Title
    JsonElement Type "web_search_result"constant
    required string Url
    string? PageAge
    class WebSearchToolRequestError:
    required WebSearchToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "max_uses_exceeded"MaxUsesExceeded
    "too_many_requests"TooManyRequests
    "query_too_long"QueryTooLong
    "request_too_large"RequestTooLarge
    JsonElement Type "web_search_tool_result_error"constant
    required string ToolUseID
    JsonElement Type "web_search_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    class WebFetchToolResultBlockParam:
    required Content Content
    Accepts one of the following:
    class WebFetchToolResultErrorBlockParam:
    required WebFetchToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "url_too_long"UrlTooLong
    "url_not_allowed"UrlNotAllowed
    "url_not_accessible"UrlNotAccessible
    "unsupported_content_type"UnsupportedContentType
    "too_many_requests"TooManyRequests
    "max_uses_exceeded"MaxUsesExceeded
    "unavailable"Unavailable
    JsonElement Type "web_fetch_tool_result_error"constant
    class WebFetchBlockParam:
    required DocumentBlockParam Content
    required Source Source
    Accepts one of the following:
    class Base64PdfSource:
    required string Data
    JsonElement MediaType "application/pdf"constant
    JsonElement Type "base64"constant
    class PlainTextSource:
    required string Data
    JsonElement MediaType "text/plain"constant
    JsonElement Type "text"constant
    class ContentBlockSource:
    required Content Content
    Accepts one of the following:
    string
    IReadOnlyList<ContentBlockSourceContent>
    Accepts one of the following:
    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    JsonElement Type "content"constant
    class UrlPdfSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "document"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    CitationsConfigParam? Citations
    Boolean Enabled
    string? Context
    string? Title
    JsonElement Type "web_fetch_result"constant
    required string Url

    Fetched content URL

    string? RetrievedAt

    ISO 8601 timestamp when the content was retrieved

    required string ToolUseID
    JsonElement Type "web_fetch_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    Caller Caller

    Tool invocation directly from the model.

    Accepts one of the following:
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class ServerToolCaller:

    Tool invocation generated by a server-side tool.

    required string ToolID
    JsonElement Type "code_execution_20250825"constant
    class ServerToolCaller20260120:
    required string ToolID
    JsonElement Type "code_execution_20260120"constant
    class CodeExecutionToolResultBlockParam:
    required CodeExecutionToolResultBlockParamContent Content

    Code execution result with encrypted stdout for PFC + web_search results.

    Accepts one of the following:
    class CodeExecutionToolResultErrorParam:
    required CodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "code_execution_tool_result_error"constant
    class CodeExecutionResultBlockParam:
    required IReadOnlyList<CodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "code_execution_result"constant
    class EncryptedCodeExecutionResultBlockParam:

    Code execution result with encrypted stdout for PFC + web_search results.

    required IReadOnlyList<CodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "code_execution_output"constant
    required string EncryptedStdout
    required Long ReturnCode
    required string Stderr
    JsonElement Type "encrypted_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "code_execution_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class BashCodeExecutionToolResultBlockParam:
    required Content Content
    Accepts one of the following:
    class BashCodeExecutionToolResultErrorParam:
    required BashCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "output_file_too_large"OutputFileTooLarge
    JsonElement Type "bash_code_execution_tool_result_error"constant
    class BashCodeExecutionResultBlockParam:
    required IReadOnlyList<BashCodeExecutionOutputBlockParam> Content
    required string FileID
    JsonElement Type "bash_code_execution_output"constant
    required Long ReturnCode
    required string Stderr
    required string Stdout
    JsonElement Type "bash_code_execution_result"constant
    required string ToolUseID
    JsonElement Type "bash_code_execution_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class TextEditorCodeExecutionToolResultBlockParam:
    required Content Content
    Accepts one of the following:
    class TextEditorCodeExecutionToolResultErrorParam:
    required TextEditorCodeExecutionToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    "file_not_found"FileNotFound
    JsonElement Type "text_editor_code_execution_tool_result_error"constant
    string? ErrorMessage
    class TextEditorCodeExecutionViewResultBlockParam:
    required string Content
    required FileType FileType
    Accepts one of the following:
    "text"Text
    "image"Image
    "pdf"Pdf
    JsonElement Type "text_editor_code_execution_view_result"constant
    Long? NumLines
    Long? StartLine
    Long? TotalLines
    class TextEditorCodeExecutionCreateResultBlockParam:
    required Boolean IsFileUpdate
    JsonElement Type "text_editor_code_execution_create_result"constant
    class TextEditorCodeExecutionStrReplaceResultBlockParam:
    JsonElement Type "text_editor_code_execution_str_replace_result"constant
    IReadOnlyList<string>? Lines
    Long? NewLines
    Long? NewStart
    Long? OldLines
    Long? OldStart
    required string ToolUseID
    JsonElement Type "text_editor_code_execution_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class ToolSearchToolResultBlockParam:
    required Content Content
    Accepts one of the following:
    class ToolSearchToolResultErrorParam:
    required ToolSearchToolResultErrorCode ErrorCode
    Accepts one of the following:
    "invalid_tool_input"InvalidToolInput
    "unavailable"Unavailable
    "too_many_requests"TooManyRequests
    "execution_time_exceeded"ExecutionTimeExceeded
    JsonElement Type "tool_search_tool_result_error"constant
    class ToolSearchToolSearchResultBlockParam:
    required IReadOnlyList<ToolReferenceBlockParam> ToolReferences
    required string ToolName
    JsonElement Type "tool_reference"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    JsonElement Type "tool_search_tool_search_result"constant
    required string ToolUseID
    JsonElement Type "tool_search_tool_result"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class ContainerUploadBlockParam:

    A content block that represents a file to be uploaded to the container Files uploaded via this block will be available in the container's input directory.

    required string FileID
    JsonElement Type "container_upload"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class ContentBlockSource:
    required Content Content
    Accepts one of the following:
    string
    IReadOnlyList<ContentBlockSourceContent>
    Accepts one of the following:
    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    JsonElement Type "content"constant
    class ContentBlockSourceContent: A class that can be one of several variants.union
    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    class DirectCaller:

    Tool invocation directly from the model.

    JsonElement Type "direct"constant
    class DocumentBlock:
    required CitationsConfig? Citations

    Citation configuration for the document

    required Boolean Enabled
    required Source Source
    Accepts one of the following:
    class Base64PdfSource:
    required string Data
    JsonElement MediaType "application/pdf"constant
    JsonElement Type "base64"constant
    class PlainTextSource:
    required string Data
    JsonElement MediaType "text/plain"constant
    JsonElement Type "text"constant
    required string? Title

    The title of the document

    JsonElement Type "document"constant
    class DocumentBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64PdfSource:
    required string Data
    JsonElement MediaType "application/pdf"constant
    JsonElement Type "base64"constant
    class PlainTextSource:
    required string Data
    JsonElement MediaType "text/plain"constant
    JsonElement Type "text"constant
    class ContentBlockSource:
    required Content Content
    Accepts one of the following:
    string
    IReadOnlyList<ContentBlockSourceContent>
    Accepts one of the following:
    class TextBlockParam:
    required string Text
    JsonElement Type "text"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    IReadOnlyList<TextCitationParam>? Citations
    Accepts one of the following:
    class CitationCharLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndCharIndex
    required Long StartCharIndex
    JsonElement Type "char_location"constant
    class CitationPageLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndPageNumber
    required Long StartPageNumber
    JsonElement Type "page_location"constant
    class CitationContentBlockLocationParam:
    required string CitedText
    required Long DocumentIndex
    required string? DocumentTitle
    required Long EndBlockIndex
    required Long StartBlockIndex
    JsonElement Type "content_block_location"constant
    class CitationWebSearchResultLocationParam:
    required string CitedText
    required string EncryptedIndex
    required string? Title
    JsonElement Type "web_search_result_location"constant
    required string Url
    class CitationSearchResultLocationParam:
    required string CitedText
    required Long EndBlockIndex
    required Long SearchResultIndex
    required string Source
    required Long StartBlockIndex
    required string? Title
    JsonElement Type "search_result_location"constant
    class ImageBlockParam:
    required Source Source
    Accepts one of the following:
    class Base64ImageSource:
    required string Data
    required MediaType MediaType
    Accepts one of the following:
    "image/jpeg"ImageJpeg
    "image/png"ImagePng
    "image/gif"ImageGif
    "image/webp"ImageWebP
    JsonElement Type "base64"constant
    class UrlImageSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "image"constant
    CacheControlEphemeral? CacheControl

    Create a cache control breakpoint at this content block.

    JsonElement Type "ephemeral"constant
    Ttl Ttl

    The time-to-live for the cache control breakpoint.

    This may be one the following values:

    • 5m: 5 minutes
    • 1h: 1 hour

    Defaults to 5m.

    Accepts one of the following:
    "5m"Ttl5m
    "1h"Ttl1h
    JsonElement Type "content"constant
    class UrlPdfSource:
    JsonElement Type "url"constant
    required string Url
    JsonElement Type "document"constant
    CacheControlEphemeral? CacheControl