SambaNova Systems Messages API

openapi: 3.2.0
info:
  title: SambaNova cloud Messages API
  description: SambaNova cloud API Specification
  version: 1.2.0
  termsOfService: https://sambanova.ai/cloud-end-user-license-agreement
  contact:
    email: info@sambanova.ai
    name: SambaNova information
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://api.sambanova.ai/v1
security:
- api_key: []
tags:
- name: Messages
paths:
  /messages:
    post:
      operationId: createMessage
      tags:
      - Messages
      summary: Create a message
      description: 'Anthropic Messages API compatible endpoint. Generates a model response for the supplied conversation. Authentication accepts either the bearer `Authorization: Bearer <key>` header (SambaNova SDK default) or the `x-api-key` header (Anthropic SDK default); the same API key is used in both cases. When `stream: true` is set, the response is a sequence of Server-Sent Events whose payloads conform to `MessageStreamEvent`; otherwise the response is a single `Message` object.'
      security:
      - api_key: []
      - x_api_key: []
      parameters:
      - in: header
        name: anthropic-version
        required: false
        description: Anthropic API version header sent by the official `anthropic` SDK. Accepted (any value) but currently has no effect on response shape — included for drop-in SDK compatibility.
        schema:
          title: Anthropic Version
          type: string
          example: '2023-06-01'
      requestBody:
        required: true
        description: Message creation parameters.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessageCreateRequest'
      responses:
        '200':
          description: 'Successful response. Returns a `Message` object (non-streaming), or a stream of Server-Sent Events whose payloads conform to `MessageStreamEvent` ending with a `message_stop` event (when `stream: true`).'
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/Message'
                - $ref: '#/components/schemas/MessageStreamEvent'
        '400':
          description: Bad Request — `invalid_request_error`. Returned for missing or invalid parameters, unsupported feature flags (e.g. `thinking` with `type:"enabled"` or `"adaptive"`), unsupported tool types (`web_search`, `code_execution`, `bash`, `text_editor`, `memory`, `tool_search` variants), image source `type:"url"`, `document` content blocks, or non-object request bodies.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '401':
          description: Unauthorized — `authentication_error`. Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '403':
          description: Forbidden — `permission_error`. API key lacks access to the requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '404':
          description: Not Found — `not_found_error`. Model does not exist or is not accessible.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '413':
          description: Payload Too Large — `request_too_large`. Request exceeds the maximum allowed size.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '429':
          description: Too Many Requests — `rate_limit_error`. Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '500':
          description: Internal Server Error — `api_error`. Unexpected issue on the server side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '501':
          description: 'Not Implemented — `not_implemented_error`. Currently returned when `stream: true` is set, until streaming support lands (PRD Phase 4).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '503':
          description: Service Unavailable — `overloaded_error`. Backend is temporarily over capacity.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
      x-codeSamples:
      - lang: JavaScript
        source: "import SambaNova from 'sambanova';\n\nconst client = new SambaNova({\n  apiKey: process.env['SAMBANOVA_API_KEY'], // This is the default and can be omitted\n});\n\nconst message = await client.messages.create({\n  max_tokens: 1024,\n  messages: [{ content: 'Hello, Claude!', role: 'user' }],\n  model: 'DeepSeek-V3.1',\n});\n\nconsole.log(message);"
      - lang: Python
        source: "import os\nfrom sambanova import SambaNova\n\nclient = SambaNova(\n    api_key=os.environ.get(\"SAMBANOVA_API_KEY\"),  # This is the default and can be omitted\n)\nfor message in client.messages.create(\n    max_tokens=1024,\n    messages=[{\n        \"content\": \"Hello, Claude!\",\n        \"role\": \"user\",\n    }],\n    model=\"DeepSeek-V3.1\",\n):\n  print(message)"
  /messages/count_tokens:
    post:
      operationId: countMessageTokens
      tags:
      - Messages
      summary: Count tokens for a message request
      description: 'Anthropic `count_tokens` compatible endpoint. Returns the number of input tokens that would be consumed by a `POST /messages` call with the same prompt content (system, messages, tools, tool_choice). Authentication accepts either the bearer `Authorization: Bearer <key>` header (SambaNova SDK default) or the `x-api-key` header (Anthropic SDK default); the same API key is used in both cases.'
      security:
      - api_key: []
      - x_api_key: []
      parameters:
      - in: header
        name: anthropic-version
        required: false
        description: Anthropic API version header sent by the official `anthropic` SDK. Accepted (any value) but currently has no effect on response shape - included for drop-in SDK compatibility.
        schema:
          title: Anthropic Version
          type: string
          example: '2023-06-01'
      requestBody:
        required: true
        description: Token counting parameters (subset of message creation parameters).
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessageCountTokensRequest'
      responses:
        '200':
          description: Successful response. Returns the input token count.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageCountTokensResponse'
        '400':
          description: Bad Request — `invalid_request_error`. Returned for missing or invalid parameters, unsupported feature flags, unsupported tool types, image source `type:"url"`, `document` content blocks, or non-object request bodies.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '401':
          description: Unauthorized — `authentication_error`. Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '403':
          description: Forbidden — `permission_error`. API key lacks access to the requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '404':
          description: Not Found — `not_found_error`. Model does not exist or is not accessible.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '413':
          description: Payload Too Large — `request_too_large`. Request exceeds the maximum allowed size.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '429':
          description: Too Many Requests — `rate_limit_error`. Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '500':
          description: Internal Server Error — `api_error`. Unexpected issue on the server side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
        '503':
          description: Service Unavailable — `overloaded_error`. Backend is temporarily over capacity.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageErrorResponse'
      x-codeSamples:
      - lang: JavaScript
        source: "import SambaNova from 'sambanova';\n\nconst client = new SambaNova({\n  apiKey: process.env['SAMBANOVA_API_KEY'], // This is the default and can be omitted\n});\n\nconst messageCountTokensResponse = await client.messages.countTokens({\n  messages: [{ content: 'Hello, Claude!', role: 'user' }],\n  model: 'DeepSeek-V3.1',\n});\n\nconsole.log(messageCountTokensResponse.input_tokens);"
      - lang: Python
        source: "import os\nfrom sambanova import SambaNova\n\nclient = SambaNova(\n    api_key=os.environ.get(\"SAMBANOVA_API_KEY\"),  # This is the default and can be omitted\n)\nmessage_count_tokens_response = client.messages.count_tokens(\n    messages=[{\n        \"content\": \"Hello, Claude!\",\n        \"role\": \"user\",\n    }],\n    model=\"DeepSeek-V3.1\",\n)\nprint(message_count_tokens_response.input_tokens)"
components:
  schemas:
    MessageInputSearchResultBlock:
      title: Message Input Search Result Block
      type: object
      description: Inline search result content. In v1 the `title`, `source`, and `content[]` text are extracted into a text block; citations are dropped.
      properties:
        type:
          type: string
          enum:
          - search_result
          const: search_result
        title:
          type: string
        source:
          type: string
        content:
          type: array
          items:
            $ref: '#/components/schemas/MessageInputTextBlock'
        citations:
          type: object
          additionalProperties: true
          nullable: true
        cache_control:
          $ref: '#/components/schemas/MessageCacheControl'
      required:
      - type
    MessageOutputWebSearchToolResultBlock:
      title: Message Output Web Search Tool Result Block
      type: object
      description: Anthropic compatibility only — SambaNova does not run server-side `web_search`. Never emitted in responses.
      properties:
        type:
          type: string
          enum:
          - web_search_tool_result
          const: web_search_tool_result
        tool_use_id:
          type: string
        content:
          type: array
          items:
            type: object
            additionalProperties: true
      required:
      - type
      - tool_use_id
      - content
    MessageInputImageBlock:
      title: Message Input Image Block
      type: object
      description: Image content. Only `source.type:"base64"` is supported in v1; URL sources return 400.
      properties:
        type:
          type: string
          enum:
          - image
          const: image
        source:
          oneOf:
          - $ref: '#/components/schemas/MessageInputImageSourceBase64'
          - $ref: '#/components/schemas/MessageInputImageSourceUrl'
          discriminator:
            propertyName: type
            mapping:
              base64: '#/components/schemas/MessageInputImageSourceBase64'
              url: '#/components/schemas/MessageInputImageSourceUrl'
        cache_control:
          $ref: '#/components/schemas/MessageCacheControl'
      required:
      - type
      - source
    MessageContentBlockSignatureDelta:
      title: Content Block Signature Delta
      type: object
      description: Signature for an open thinking block. Emitted at the end of a thinking stream (paired with the closing `content_block_stop`); the `signature` value may be an empty string when the backend has no signed payload to attach.
      properties:
        type:
          type: string
          enum:
          - signature_delta
          const: signature_delta
        signature:
          type: string
      required:
      - type
      - signature
    MessageContentBlockStartEvent:
      title: Content Block Start Event
      type: object
      description: Opens a new content block. One per block in `content[]`.
      properties:
        type:
          type: string
          enum:
          - content_block_start
          const: content_block_start
        index:
          type: integer
          description: Zero-based index of the block within `content[]`.
        content_block:
          $ref: '#/components/schemas/MessageOutputContentBlock'
      required:
      - type
      - index
      - content_block
    MessageOutputContainerUploadBlock:
      title: Message Output Container Upload Block
      type: object
      description: Anthropic compatibility only — SambaNova does not produce container_upload blocks (these come from Anthropic's server-side `code_execution` tool). Never emitted in responses.
      properties:
        type:
          type: string
          enum:
          - container_upload
          const: container_upload
        file_id:
          type: string
      required:
      - type
      - file_id
    MessageErrorResponse:
      title: Message Error Response
      type: object
      description: Top-level error envelope returned by the Messages API on any non-2xx response. Shape matches Anthropic's wire format. This envelope is used ONLY on `/messages` and `/messages/count_tokens`
      properties:
        type:
          title: Type
          type: string
          description: Always `error` for error envelopes.
          enum:
          - error
          const: error
        error:
          $ref: '#/components/schemas/MessageError'
        request_id:
          title: Request Id
          type: string
          description: Opaque request identifier echoed by the server, useful for correlating client-side failures with server-side logs.
          nullable: true
      required:
      - type
      - error
    MessageTool:
      title: Message Tool
      type: object
      description: User-defined function tool definition. Only custom function tools are supported (Anthropic's `type:"custom"` style or the absent-type Beta style). Anthropic-hosted server tools (`web_search`, `code_execution`, `bash`, `text_editor`, `memory`, `tool_search` variants) return 400 `unsupported_tool_type` if sent.
      properties:
        name:
          type: string
          description: Tool name. Must match `^[a-zA-Z0-9_-]+$`.
        type:
          type: string
          enum:
          - custom
          nullable: true
          description: Tool-type discriminator. May be omitted (defaults to custom) or set to `custom`. Other values return 400 `unsupported_tool_type`.
        description:
          type: string
          nullable: true
          description: Human-readable description of when the tool should be used.
        input_schema:
          type: object
          additionalProperties: true
          nullable: true
          description: JSON Schema describing the tool's expected input. Required by the Anthropic spec; accepted as optional by SambaNova.
        cache_control:
          allOf:
          - $ref: '#/components/schemas/MessageCacheControl'
          nullable: true
          description: Silently dropped on tool definitions (only content and system cache markers participate in caching).
        input_examples:
          type: array
          items:
            type: object
            additionalProperties: true
          nullable: true
          description: Silently dropped.
        allowed_callers:
          type: array
          items:
            type: string
          nullable: true
          description: Silently dropped.
        defer_loading:
          type: boolean
          nullable: true
          description: Silently dropped.
        eager_input_streaming:
          type: boolean
          nullable: true
          description: Silently dropped.
        strict:
          type: boolean
          nullable: true
          description: Silently dropped.
      required:
      - name
    MessageInputRedactedThinkingBlock:
      title: Message Input Redacted Thinking Block
      type: object
      description: Anthropic compatibility only — SambaNova does not produce encrypted thinking output. Echo of a prior Anthropic-served response where `thinking.display:"omitted"` was set. Accepted in conversation history but never originates from a SambaNova response. Silently dropped on input.
      properties:
        type:
          type: string
          enum:
          - redacted_thinking
          const: redacted_thinking
        data:
          type: string
      required:
      - type
      - data
    MessageContentBlockTextDelta:
      title: Content Block Text Delta
      type: object
      description: Incremental text chunk for an open text content block.
      properties:
        type:
          type: string
          enum:
          - text_delta
          const: text_delta
        text:
          type: string
      required:
      - type
      - text
    MessageStreamErrorEvent:
      title: Message Stream Error Event
      type: object
      description: Streamed error envelope. Terminates the stream.
      properties:
        type:
          type: string
          enum:
          - error
          const: error
        error:
          $ref: '#/components/schemas/MessageError'
      required:
      - type
      - error
    MessageContainer:
      title: Message Container
      type: object
      description: Code-execution container reference. Anthropic compatibility only — SambaNova does not run server-side code execution, so this field is never emitted on responses.
      properties:
        id:
          type: string
        expires_at:
          type: string
          description: ISO-8601 timestamp.
      required:
      - id
      - expires_at
    MessageInputMessage:
      title: Message Input Message
      type: object
      description: A turn in the conversation.
      properties:
        role:
          type: string
          enum:
          - user
          - assistant
          description: Conversational role. `user` for the human-side turn, `assistant` for prior model output.
        content:
          anyOf:
          - type: string
          - title: Content Block Array
            type: array
            items:
              $ref: '#/components/schemas/MessageInputContentBlock'
      required:
      - role
      - content
    MessageInputDocumentBlock:
      title: Message Input Document Block
      type: object
      description: PDF or document content. **Returns 400** — no document-extraction pipeline available.
      properties:
        type:
          type: string
          enum:
          - document
          const: document
        source:
          type: object
          additionalProperties: true
        title:
          type: string
          nullable: true
        context:
          type: string
          nullable: true
        citations:
          type: object
          additionalProperties: true
          nullable: true
        cache_control:
          $ref: '#/components/schemas/MessageCacheControl'
      required:
      - type
      - source
    MessageDeltaEvent:
      title: Message Delta Event
      type: object
      description: Penultimate event of the stream. Carries the final `stop_reason`, optional `stop_sequence`, and final usage counts.
      properties:
        type:
          type: string
          enum:
          - message_delta
          const: message_delta
        delta:
          type: object
          properties:
            stop_reason:
              $ref: '#/components/schemas/MessageStopReason'
            stop_sequence:
              type: string
              nullable: true
              description: Custom stop sequence that triggered termination. Field is emitted but value is always `null` in v1 (backend collapses `StopSequenceHit` and `EndOfText` into the same finish_reason).
            stop_details:
              allOf:
              - $ref: '#/components/schemas/MessageStopDetails'
              nullable: true
              description: Refusal stop details. Field is emitted but value is always `null` in v1 — `refusal` is not produced as a stop_reason.
          required:
          - stop_reason
        usage:
          $ref: '#/components/schemas/MessageDeltaUsage'
      required:
      - type
      - delta
      - usage
    MessageOutputBashCodeExecutionToolResultBlock:
      title: Message Output Bash Code Execution Tool Result Block
      type: object
      description: Anthropic compatibility only — SambaNova does not run server-side bash code execution. Never emitted in responses.
      properties:
        type:
          type: string
          enum:
          - bash_code_execution_tool_result
          const: bash_code_execution_tool_result
        tool_use_id:
          type: string
        content:
          type: object
          additionalProperties: true
      required:
      - type
      - tool_use_id
      - content
    MessageContentBlockDelta:
      title: Content Block Delta
      description: Incremental update to an open content block.
      oneOf:
      - $ref: '#/components/schemas/MessageContentBlockTextDelta'
      - $ref: '#/components/schemas/MessageContentBlockInputJsonDelta'
      - $ref: '#/components/schemas/MessageContentBlockThinkingDelta'
      - $ref: '#/components/schemas/MessageContentBlockSignatureDelta'
      discriminator:
        propertyName: type
        mapping:
          text_delta: '#/components/schemas/MessageContentBlockTextDelta'
          input_json_delta: '#/components/schemas/MessageContentBlockInputJsonDelta'
          thinking_delta: '#/components/schemas/MessageContentBlockThinkingDelta'
          signature_delta: '#/components/schemas/MessageContentBlockSignatureDelta'
    MessageThinkingEnabled:
      title: Message Thinking Enabled
      type: object
      description: 'Enables Anthropic-style extended thinking with a fixed budget. **In v1**: returns a 400 `invalid_request_error` (`unsupported_parameter`).'
      properties:
        type:
          title: Type
          type: string
          enum:
          - enabled
          const: enabled
        budget_tokens:
          title: Budget Tokens
          type: integer
          minimum: 1024
          description: Maximum tokens the model may spend on extended thinking before producing the final answer.
      required:
      - type
      - budget_tokens
    MessageUsage:
      title: Message Usage
      type: object
      description: Token accounting for the request.
      properties:
        input_tokens:
          type: integer
          description: Total tokens in the prompt (system + messages + tools).
        output_tokens:
          type: integer
          description: Total tokens generated by the model.
        cache_creation_input_tokens:
          type: integer
          nullable: true
          description: Tokens written to prompt cache. Absent in v1; emitted once prompt caching wiring lands (CP-2897).
        cache_read_input_tokens:
          type: integer
          nullable: true
          description: Tokens read from prompt cache. Absent in v1; emitted once prompt caching wiring lands (CP-2897).
        server_tool_use:
          type: object
          additionalProperties: true
          nullable: true
          description: Server-tool usage metrics (e.g. `web_search_requests`). Anthropic compatibility only — SambaNova does not run server tools, so this field is never emitted.
        service_tier:
          type: string
          nullable: true
          description: Service tier that processed the request. Anthropic compatibility only — SambaNova is single-tier and never emits this field.
        cache_creation:
          type: object
          additionalProperties: true
          nullable: true
          description: Anthropic SDK alias for cache write metrics. Always `null` in SambaNova responses; use `cache_creation_input_tokens` instead.
        inference_geo:
          type: string
          nullable: true
          description: Geographic region that served the request. Anthropic compatibility only - SambaNova does not expose geo routing, always `null`.
      required:
      - input_tokens
      - output_tokens
    MessageInputServerToolUseBlock:
      title: Message Input Server Tool Use Block
      type: object
      description: Anthropic compatibility only — SambaNova does not run server-side tools. A prior assistant turn that invoked an Anthropic-hosted tool (web_search, code_execution, etc.). Accepted in conversation history (e.g. replaying an Anthropic-served session) but never originates from a SambaNova response. New `server_tool_use`-type tool definitions on outgoing requests are rejected with 400 `unsupported_tool_type`.
      properties:
        type:
          type: string
          enum:
          - server_tool_use
          const: server_tool_use
        id:
          type: string
        name:
          type: string
        input:
          type: object
          additionalProperties: true
        cache_control:
          $ref: '#/components/schemas/MessageCacheControl'
      required:
      - type
      - id
      - name
      - input
    MessageOutputToolUseBlock:
      title: Message Output Tool Use Block
      type: object
      description: Tool call generated by the model.
      properties:
        type:
          type: string
          enum:
          - tool_use
          const: tool_use
        id:
          type: string
          description: Unique identifier for this tool call.
        name:
          type: string
          description: Name of the tool being called.
        input:
          type: object
          additionalProperties: true
          description: Tool inputs as a JSON object.
        caller:
          type: object
          additionalProperties: true
          nullable: true
          description: Anthropic routing metadata. Always `null` in SambaNova responses.
      required:
      - type
      - id
      - name
      - input
    MessageStopDetails:
      title: Message Stop Details
      type: object
      description: Refusal stop details. Anthropic compatibility only — `refusal` is never emitted as a stop_reason by SambaNova (content filtering is not exposed at the API layer).
      properties:
        type:
          type: string
          enum:
          - refusal
          const: refusal
        category:
          type: string
          enum:
          - cyber
          - bio
      required:
      - type
    MessageInputToolSearchToolResultBlock:
      title: Message Input Tool Search Tool Result Block
      type: object
      description: Anthropic compatibility only — SambaNova does not run server-side `tool_search`. Echo of a prior Anthropic-served `tool_search` tool call; accepted in conversation history but never originates from a SambaNova response. When present, an empty string is emitted to the tool message (no plain-text fields).
      properties:
        type:
          type: string
          enum:
          - tool_search_tool_result
          const: tool_search_tool_result
        tool_use_id:
          type: string
        content:
          type: object
          additionalProperties: true
        cache_control:
          $ref: '#/components/schemas/MessageCacheControl'
      required:
      - type
      - tool_use_id
      - content
    MessageInputToolUseBlock:
      title: Message Input Tool Use Block
      type: object
      description: A prior assistant turn that invoked a tool.
      properties:
        type:
          type: string
          enum:
          - tool_use
          const: tool_use
        id:
          type: string
          description: Unique identifier for the tool call (used to correlate `tool_result`).
        name:
          type: string
          description: Name of the tool being invoked.
        input:
          type: object
          additionalProperties: true
          description: Tool inputs as a JSON object.
        cache_control:
          $ref: '#/components/schemas/MessageCacheControl'
      required:
      - type
      - id
      - name
      - input
    MessageThinkingConfig:
      title: Message Thinking Config
      description: 'Controls Anthropic-style extended thinking. **In v1**: only `type:"disabled"` is silently accepted as a no-op; `type:"enabled"` and `type:"adaptive"` return a 400 `invalid_request_error` (`unsupported_parameter`).'
      oneOf:
      - $ref: '#/components/schemas/MessageThinkingDisabled'
      - $ref: '#/components/schemas/MessageThinkingEnabled'
      - $ref: '#/components/schemas/MessageThinkingAdaptive'
      discriminator:
        propertyName: type
        mapping:
          disabled: '#/components/schemas/MessageThinkingDisabled'
          enabled: '#/components/schemas/MessageThinkingEnabled'
          adaptive: '#/components/schemas/MessageThinkingAdaptive'
    MessageStartEvent:
      title: Message Start Event
      type: object
      description: 'First event of a stream. Carries the initial Message envelope (empty `content[]`, `stop_reason: null`) and token usage from prompt processing.'
      properties:
        type:
          type: string
          enum:
          - message_start
          const: message_start
        message:
          $ref: '#/components/schemas/Message'
      required:
      - type
      - message
    MessageOutputToolSearchToolResultBlock:
      title: Message Output Tool Search Tool Result Block
      type: object
      description: Anthropic compatibility only — SambaNova does not run server-side `tool_search`. Never emitted in responses.
      properties:
        type:
          type: string
          enum:
          - tool_search_tool_result
          const: tool_search_tool_result
        tool_use_id:
          type: string
        content:
          type: object
          additionalProperties: true
      required:
      - type
      - tool_use_id
      - content
    MessageStreamEvent:
      title: Message Stream Event
      description: 'Discriminated union of SSE events emitted during a streaming `POST /messages` call. Event order: `message_start` -> (`content_block_start` -> `content_block_delta`×N -> `content_block_stop`) × blocks -> `message_delta` -> `message_stop`. A `ping` may appear at any point; an `error` event terminates the stream.'
      oneOf:
      - $ref: '#/components/schemas/MessageStartEvent'
      - $ref: '#/components/schemas/MessageContentBlockStartEvent'
      - $ref: '#/components/schemas/MessageContentBlockDeltaEvent'
      - $ref: '#/components/schemas/MessageContentBlockStopEvent'
      - $ref: '#/components/schemas/MessageDeltaEvent'
      - $ref: '#/components/schemas/MessageStopEvent'
      - $ref: '#/components/schemas/MessagePingEvent'
      - $ref: '#/components/schemas/MessageStreamErrorEvent'
      discriminator:
        propertyName: type
        mapping:
          message_start: '#/components/schemas/MessageStartEvent'
          content_block_start: '#/components/schemas/MessageContentBlockStartEvent'
          content_block_delta: '#/components/schemas/MessageContentBlockDeltaEvent'
          content_block_stop: '#/components/schemas/MessageContentBlockStopEvent'
          message_delta: '#/components/schemas/MessageDeltaEvent'
          message_stop: '#/components/schemas/MessageStopEvent'
          ping: '#/components/schemas/MessagePingEvent'
          error: '#/components/schemas/MessageStreamErrorEvent'
    MessageInputCodeExecutionToolResultBlock:
      title: Message Input Code Executi

# --- truncated at 32 KB (69 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sambanova-systems/refs/heads/main/openapi/sambanova-systems-messages-api-openapi.yml