---
title: "Create OpenResponse"
method: POST
path: "/v1/responses"
tags: ["OpenResponses"]
---

# Create OpenResponse

`POST /v1/responses`

OpenResponses endpoint backed by Arrow. Hosted QuiverAI tools execute upstream and return namespaced receipt items. Streaming ends with the literal [DONE] transport sentinel.

## Headers

- `x-trace-id` string — Optional client-supplied trace identifier. The API echoes this value in `X-Trace-ID` and includes it in request logs for client-side correlation.

## Request body

- OpenResponsesCreateRequest
  - `background` boolean, nullable
  - `input` union, required
    - string
    - union[]
      - union
        - object
          - `content` union, required
            - string
            - union[]
              - …
          - `id` string, nullable
          - `phase` 'commentary' | 'final_answer' | 'null', nullable
          - `role` 'assistant' | 'developer' | 'system' | 'user', required
          - `status` 'in_progress' | 'completed' | 'incomplete' | 'null', nullable
          - `type` 'message'
        - object
          - `arguments` string
          - `call_id` string, required
          - `id` string, nullable
          - `name` string, required
          - `status` 'in_progress' | 'completed' | 'incomplete' | 'null', nullable
          - `type` 'function_call', required
        - object
          - `call_id` string, required
          - `id` string, nullable
          - `output` union, required
            - string
            - union[]
              - …
          - `status` 'in_progress' | 'completed' | 'incomplete' | 'null', nullable
          - `type` 'function_call_output', required
        - object
          - `id` string, required
          - `status` 'completed', nullable
          - `summary` object[], nullable
            - `text` string, required
            - `type` 'summary_text'
          - `type` 'reasoning'
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `attributes` object, nullable
            - `auto_crop` boolean, nullable
            - `n` integer, nullable
            - `prompt` string, nullable
            - `references` object[], nullable
              - …
            - `sRef` string, nullable
            - `settings` object, nullable
              - …
            - `style` object, nullable
              - …
          - `result` object, nullable
            - `created` integer, required
            - `data` object[], required
              - …
            - `id` string, required
            - `sRef` string, nullable
            - `style_created` boolean
            - `svg_score` number, nullable
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:svg_generation_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `attributes` object, nullable
            - `auto_crop` boolean, nullable
            - `image` object, nullable
              - …
            - `max_output_tokens` integer, nullable
            - `presence_penalty` number, nullable
            - `target_size` integer, nullable
            - `temperature` number, nullable
            - `top_p` number, nullable
          - `result` object, nullable
            - `created` integer, required
            - `data` object[], required
              - …
            - `id` string, required
            - `svg_score` number, nullable
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:svg_vectorization_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `prompt` string, nullable
            - `settings` object, nullable
              - …
            - `svg_source` object, nullable
              - …
          - `result` object, nullable
            - `created` integer, required
            - `data` object[], required
              - …
            - `id` string, required
            - `svg_score` number, nullable
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:svg_animation_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `max_review_steps` integer
            - `prompt` string, nullable
            - `reference_images` object[], nullable
              - …
            - `settings` object, nullable
              - …
            - `svg_ref` string, nullable
            - `svg_source` object, nullable
              - …
          - `result` object, nullable
            - `created` integer, required
            - `data` object[], required
              - …
            - `id` string, required
            - `svg_score` number, nullable
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:svg_editing_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `attributes` object, nullable
            - `prompt` string, nullable
            - `references` object[], nullable
              - …
          - `result` object, nullable
            - `created` integer, required
            - `id` string, required
            - `sRef` string, required
            - `style` object, required
              - …
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:style_creation_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `attributes` object, nullable
            - `auto_crop` boolean, nullable
            - `prompt` string, nullable
            - `sRef` string, nullable
            - `settings` object, nullable
              - …
            - `style` object, nullable
              - …
            - `subjects` object[], nullable
              - …
          - `result` object, nullable
            - `created` integer, required
            - `data` object[], required
              - …
            - `id` string, required
            - `sRef` string, required
            - `style_created` boolean, required
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:icon_generation_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `prompt` string, nullable
            - `references` object[], nullable
              - …
            - `sRef` string, nullable
            - `settings` object, nullable
              - …
            - `svg_source` object, nullable
              - …
          - `result` object, nullable
            - `created` integer, required
            - `id` string, required
            - `sRef` string, nullable
            - `svg` string, required
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:icon_editing_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `glyph_set` '36' | '72' | 'null', nullable
            - `prompt` string, nullable
            - `references` object[], nullable
              - …
            - `settings` object, nullable
              - …
            - `skip_ttf` boolean, nullable
          - `result` object, nullable
            - `created` integer, required
            - `error_ttf` boolean
            - `font_name` string, required
            - `glyph_count` integer, required
            - `id` string, required
            - `partial_svg` boolean, required
            - `partial_ttf` boolean, required
            - `sRef` string, nullable
            - `style_created` boolean
            - `svg_count` integer, required
            - `svgs` object, required
            - `ttf_base64` string, nullable
            - `ttf_excluded_glyphs` string[], required
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:font_generation_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `glyph_name` string, nullable
            - `prompt` string, nullable
            - `references` object[], nullable
              - …
            - `settings` object, nullable
              - …
            - `svg_source` object, nullable
              - …
          - `result` object, nullable
            - `created` integer, required
            - `glyph_name` string, nullable
            - `id` string, required
            - `svg` string, required
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:font_glyph_editing_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `glyph_set` 'ascii_basic_36_extension' | 'ascii_extra_symbols_1' | 'ascii_extra_symbols_2' | 'null', nullable
            - `settings` object, nullable
              - …
            - `ttf_ref` string, nullable
          - `result` object, nullable
            - `created` integer, required
            - `error_ttf` boolean
            - `glyph_count` integer, required
            - `glyph_set` 'ascii_basic_36_extension' | 'ascii_extra_symbols_1' | 'ascii_extra_symbols_2', required
            - `id` string, required
            - `partial_svg` boolean, required
            - `partial_ttf` boolean, required
            - `reference_chars` string, required
            - `svg_count` integer, required
            - `svgs` object, required
            - `target_glyphs` string[], required
            - `ttf_excluded_glyphs` string[], required
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:font_expansion_call', required
        - object
          - `error` object, nullable
            - `code` string, nullable
            - `message` string, required
            - `param` string, nullable
            - `status_code` integer, nullable
            - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
          - `id` string, required
          - `input` object, required
            - `font_name` string, nullable
            - `format` 'ttf', nullable
            - `lax_export` boolean, nullable
            - `svg_refs` object, nullable
          - `result` object, nullable
            - `created` integer, required
            - `font_base64` string, required
            - `font_name` string, required
            - `format` 'ttf', required
            - `glyph_count` integer, required
            - `id` string, required
            - `partial_ttf` boolean, required
            - `ttf_excluded_glyphs` string[], required
            - `usage` object, nullable
              - …
          - `status` 'in_progress' | 'completed' | 'failed', required
          - `type` 'quiver:font_export_call', required
  - `instructions` string, nullable
  - `max_output_tokens` integer, nullable
  - `max_tool_calls` integer, nullable
  - `metadata` object
  - `model` string, required
  - `parallel_tool_calls` boolean
  - `presence_penalty` number
  - `previous_response_id` string, nullable
  - `reasoning` object
    - `effort` 'low' | 'medium' | 'high' | 'xhigh'
    - `summary` 'auto', nullable
  - `store` boolean
  - `stream` boolean
  - `temperature` number
  - `tool_choice` union
    - 'auto' | 'none' | 'required'
    - object
      - `name` string, required
      - `type` 'function', required
    - object
      - `type` 'quiver:svg_generation' | 'quiver:svg_vectorization' | 'quiver:svg_animation' | 'quiver:svg_editing' | 'quiver:style_creation' | 'quiver:icon_generation' | 'quiver:icon_editing' | 'quiver:font_generation' | 'quiver:font_glyph_editing' | 'quiver:font_expansion' | 'quiver:font_export', required
    - object
      - `mode` 'auto' | 'required', required
      - `tools` union[], required
        - union
          - object
            - `name` string, required
            - `type` 'function', required
          - object
            - `type` 'quiver:svg_generation' | 'quiver:svg_vectorization' | 'quiver:svg_animation' | 'quiver:svg_editing' | 'quiver:style_creation' | 'quiver:icon_generation' | 'quiver:icon_editing' | 'quiver:font_generation' | 'quiver:font_glyph_editing' | 'quiver:font_expansion' | 'quiver:font_export', required
      - `type` 'allowed_tools', required
  - `tools` union[], nullable
    - union
      - object
        - `attributes` object, nullable
        - `auto_crop` boolean, nullable
        - `n` integer, nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `sRef` string, nullable
        - `settings` object, nullable
          - `aspect_ratio` string, nullable
          - `instructions` string, nullable
          - `max_output_tokens` integer, nullable
          - `presence_penalty` number, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
          - `top_p` number, nullable
        - `style` object, nullable
          - `attributes` object, nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `type` 'quiver:svg_generation', required
      - object
        - `attributes` object, nullable
        - `auto_crop` boolean, nullable
        - `image` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `max_output_tokens` integer, nullable
        - `presence_penalty` number, nullable
        - `target_size` integer, nullable
        - `temperature` number, nullable
        - `top_p` number, nullable
        - `type` 'quiver:svg_vectorization', required
      - object
        - `prompt` string, nullable
        - `settings` object, nullable
          - `max_output_tokens` integer, nullable
          - `temperature` number, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:svg_animation', required
      - object
        - `max_review_steps` integer
        - `prompt` string, nullable
        - `reference_images` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `settings` object, nullable
          - `max_output_tokens` integer, nullable
          - `orchestrator_max_output_tokens` integer, nullable
          - `shallow_max_output_tokens` integer, nullable
          - `temperature` number, nullable
        - `svg` string, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:svg_editing', required
      - object
        - `attributes` object, nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:style_creation', required
      - object
        - `attributes` object, nullable
        - `auto_crop` boolean, nullable
        - `prompt` string, nullable
        - `sRef` string, nullable
        - `settings` object, nullable
          - `aspect_ratio` string, nullable
          - `instructions` string, nullable
          - `max_output_tokens` integer, nullable
          - `presence_penalty` number, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
          - `top_p` number, nullable
        - `style` object, nullable
          - `attributes` object, nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `subjects` object[], nullable
          - `image` object, nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `text` string, required
        - `type` 'quiver:icon_generation', required
      - object
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `sRef` string, nullable
        - `settings` object, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:icon_editing', required
      - object
        - `glyph_set` '36' | '72' | 'null', nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `settings` object, nullable
          - `seed` integer, nullable
        - `skip_ttf` boolean, nullable
        - `type` 'quiver:font_generation', required
      - object
        - `glyph_name` string, nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `settings` object, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:font_glyph_editing', required
      - object
        - `glyph_set` 'ascii_basic_36_extension' | 'ascii_extra_symbols_1' | 'ascii_extra_symbols_2' | 'null', nullable
        - `settings` object, nullable
          - `seed` integer, nullable
        - `ttf_base64` string, nullable
        - `type` 'quiver:font_expansion', required
      - object
        - `font_name` string, nullable
        - `format` 'ttf', nullable
        - `lax_export` boolean, nullable
        - `svgs` object, nullable
        - `type` 'quiver:font_export', required
      - object
        - `description` string, nullable
        - `name` string, required
        - `parameters` object, nullable, required
        - `strict` boolean, nullable, required
        - `type` 'function', required
  - `top_p` number
  - `websocket` boolean, nullable

## Response `200`

OpenResponses-compatible ResponseResource returned by the upstream inference service.

- OpenResponsesResponse
  - `background` false
  - `completed_at` integer, nullable
  - `created_at` integer, required
  - `error` object, nullable
    - `code` 'server_error' | 'rate_limit_exceeded' | 'invalid_prompt' | 'vector_store_timeout' | 'invalid_image' | 'invalid_image_format' | 'invalid_base64_image' | 'invalid_image_url' | 'image_too_large' | 'image_too_small' | 'image_parse_error' | 'image_content_policy_violation' | 'invalid_image_mode' | 'image_file_too_large' | 'unsupported_image_media_type' | 'empty_image_file' | 'failed_to_download_image' | 'image_file_not_found', required
    - `message` string, required
    - `quiver_code` 'invalid_request' | 'unsupported_animation_request' | 'image_dimensions_too_large' | 'missing_reference_image' | 'too_many_reference_images' | 'too_many_subjects' | 'artwork_ids_mismatch' | 'invalid_image_url' | 'image_url_restricted' | 'image_url_unresolved' | 'image_fetch_failed' | 'image_payload_too_large' | 'invalid_image_payload' | 'unsupported_image_reference' | 'invalid_svg_source' | 'svg_too_large' | 'content_policy_violation' | 'rate_limited' | 'request_timeout' | 'upstream_error' | 'internal_error' | 'null', nullable
    - `status_code` integer, nullable
  - `frequency_penalty` number
  - `id` string, required
  - `incomplete_details` object, nullable
    - `code` 'invalid_request' | 'unsupported_animation_request' | 'image_dimensions_too_large' | 'missing_reference_image' | 'too_many_reference_images' | 'too_many_subjects' | 'artwork_ids_mismatch' | 'invalid_image_url' | 'image_url_restricted' | 'image_url_unresolved' | 'image_fetch_failed' | 'image_payload_too_large' | 'invalid_image_payload' | 'unsupported_image_reference' | 'invalid_svg_source' | 'svg_too_large' | 'content_policy_violation' | 'rate_limited' | 'request_timeout' | 'upstream_error' | 'internal_error' | 'null', nullable
    - `message` string, nullable
    - `reason` 'content_filter' | 'max_output_tokens', required
    - `status_code` integer, nullable
  - `instructions` string, nullable, required
  - `max_output_tokens` integer, nullable, required
  - `max_tool_calls` integer, nullable
  - `metadata` object, required
  - `model` string, required
  - `object` 'response'
  - `output` union[], required
    - union
      - object
        - `arguments` string
        - `call_id` string, required
        - `id` string, required
        - `name` string, required
        - `status` 'completed'
        - `type` 'function_call'
      - object
        - `call_id` string, required
        - `id` string, required
        - `output` string, required
        - `status` 'completed'
        - `type` 'function_call_output'
      - object
        - `id` string, required
        - `status` 'completed'
        - `summary` object[], required
          - `text` string, required
          - `type` 'summary_text'
        - `type` 'reasoning'
      - object
        - `content` object[], required
          - `annotations` object[]
          - `text` string, required
          - `type` 'output_text'
        - `id` string, required
        - `phase` 'commentary' | 'final_answer'
        - `role` 'assistant'
        - `status` 'completed'
        - `type` 'message'
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `attributes` object, nullable
          - `auto_crop` boolean, nullable
          - `n` integer, nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `sRef` string, nullable
          - `settings` object, nullable
            - `aspect_ratio` string, nullable
            - `instructions` string, nullable
            - `max_output_tokens` integer, nullable
            - `presence_penalty` number, nullable
            - `seed` integer, nullable
            - `temperature` number, nullable
            - `top_p` number, nullable
          - `style` object, nullable
            - `attributes` object, nullable
            - `prompt` string, nullable
            - `references` object[], nullable
              - …
        - `result` object, nullable
          - `created` integer, required
          - `data` object[], required
            - `mime_type` 'image/svg+xml', required
            - `svg` string, required
          - `id` string, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `sRef` string, nullable
          - `style_created` boolean
          - `svg_score` number, nullable
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:svg_generation_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `attributes` object, nullable
          - `auto_crop` boolean, nullable
          - `image` object, nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `max_output_tokens` integer, nullable
          - `presence_penalty` number, nullable
          - `target_size` integer, nullable
          - `temperature` number, nullable
          - `top_p` number, nullable
        - `result` object, nullable
          - `created` integer, required
          - `data` object[], required
            - `mime_type` 'image/svg+xml', required
            - `svg` string, required
          - `id` string, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `svg_score` number, nullable
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:svg_vectorization_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `prompt` string, nullable
          - `settings` object, nullable
            - `max_output_tokens` integer, nullable
            - `temperature` number, nullable
          - `svg_source` object, nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `result` object, nullable
          - `created` integer, required
          - `data` object[], required
            - `loop_period_ms` integer, nullable
            - `mime_type` 'image/svg+xml', required
            - `opening_animation_ms` integer, nullable
            - `svg` string, required
          - `id` string, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `svg_score` number, nullable
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:svg_animation_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `max_review_steps` integer
          - `prompt` string, nullable
          - `reference_images` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `settings` object, nullable
            - `max_output_tokens` integer, nullable
            - `orchestrator_max_output_tokens` integer, nullable
            - `shallow_max_output_tokens` integer, nullable
            - `temperature` number, nullable
          - `svg_ref` string, nullable
          - `svg_source` object, nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `result` object, nullable
          - `created` integer, required
          - `data` object[], required
            - `mime_type` 'image/svg+xml', required
            - `svg` string, required
          - `id` string, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `svg_score` number, nullable
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:svg_editing_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `attributes` object, nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `result` object, nullable
          - `created` integer, required
          - `id` string, required
          - `sRef` string, required
          - `style` object, required
            - `created` integer, required
            - `forked_from` string, nullable
            - `origin` object, required
              - …
            - `parent_sRef` string, nullable
            - `reference_preparation` object, nullable
              - …
            - `references` object[]
              - …
            - `sRef` string, required
            - `schema_version` string
            - `style` object, required
              - …
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:style_creation_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `attributes` object, nullable
          - `auto_crop` boolean, nullable
          - `prompt` string, nullable
          - `sRef` string, nullable
          - `settings` object, nullable
            - `aspect_ratio` string, nullable
            - `instructions` string, nullable
            - `max_output_tokens` integer, nullable
            - `presence_penalty` number, nullable
            - `seed` integer, nullable
            - `temperature` number, nullable
            - `top_p` number, nullable
          - `style` object, nullable
            - `attributes` object, nullable
            - `prompt` string, nullable
            - `references` object[], nullable
              - …
          - `subjects` object[], nullable
            - `image` object, nullable
              - …
            - `text` string, required
        - `result` object, nullable
          - `created` integer, required
          - `data` object[], required
            - `artwork_id` string, required
            - `mime_type` string
            - `status` 'completed' | 'failed'
            - `subject` string, required
            - `svg` string, required
          - `id` string, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `sRef` string, required
          - `style_created` boolean, required
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:icon_generation_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `sRef` string, nullable
          - `settings` object, nullable
            - `seed` integer, nullable
            - `temperature` number, nullable
          - `svg_source` object, nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `result` object, nullable
          - `created` integer, required
          - `id` string, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `sRef` string, nullable
          - `svg` string, required
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:icon_editing_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `glyph_set` '36' | '72' | 'null', nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `settings` object, nullable
            - `seed` integer, nullable
          - `skip_ttf` boolean, nullable
        - `result` object, nullable
          - `created` integer, required
          - `error_ttf` boolean
          - `font_name` string, required
          - `glyph_count` integer, required
          - `id` string, required
          - `partial_svg` boolean, required
          - `partial_ttf` boolean, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `sRef` string, nullable
          - `style_created` boolean
          - `svg_count` integer, required
          - `svgs` object, required
          - `ttf_base64` string, nullable
          - `ttf_excluded_glyphs` string[], required
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:font_generation_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `glyph_name` string, nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `settings` object, nullable
            - `seed` integer, nullable
            - `temperature` number, nullable
          - `svg_source` object, nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `result` object, nullable
          - `created` integer, required
          - `glyph_name` string, nullable
          - `id` string, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `svg` string, required
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:font_glyph_editing_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `glyph_set` 'ascii_basic_36_extension' | 'ascii_extra_symbols_1' | 'ascii_extra_symbols_2' | 'null', nullable
          - `settings` object, nullable
            - `seed` integer, nullable
          - `ttf_ref` string, nullable
        - `result` object, nullable
          - `created` integer, required
          - `error_ttf` boolean
          - `glyph_count` integer, required
          - `glyph_set` 'ascii_basic_36_extension' | 'ascii_extra_symbols_1' | 'ascii_extra_symbols_2', required
          - `id` string, required
          - `partial_svg` boolean, required
          - `partial_ttf` boolean, required
          - `reasoning_effort` 'low' | 'medium' | 'high' | 'xhigh'
          - `reference_chars` string, required
          - `svg_count` integer, required
          - `svgs` object, required
          - `target_glyphs` string[], required
          - `ttf_excluded_glyphs` string[], required
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:font_expansion_call', required
      - object
        - `error` object, nullable
          - `code` string, nullable
          - `message` string, required
          - `param` string, nullable
          - `status_code` integer, nullable
          - `type` 'invalid_request' | 'tool_error' | 'upstream_error' | 'internal_error', required
        - `id` string, required
        - `input` object, required
          - `font_name` string, nullable
          - `format` 'ttf', nullable
          - `lax_export` boolean, nullable
          - `svg_refs` object, nullable
        - `result` object, nullable
          - `created` integer, required
          - `font_base64` string, required
          - `font_name` string, required
          - `format` 'ttf', required
          - `glyph_count` integer, required
          - `id` string, required
          - `partial_ttf` boolean, required
          - `ttf_excluded_glyphs` string[], required
          - `usage` object, nullable
            - `input_tokens` integer, required
            - `input_tokens_details` object
              - …
            - `output_tokens` integer, required
            - `output_tokens_details` object
              - …
            - `total_tokens` integer, required
        - `status` 'in_progress' | 'completed' | 'failed', required
        - `type` 'quiver:font_export_call', required
  - `parallel_tool_calls` boolean
  - `presence_penalty` number, required
  - `previous_response_id` string, nullable
  - `prompt_cache_key` string, nullable
  - `reasoning` object
    - `effort` 'low' | 'medium' | 'high' | 'xhigh'
    - `summary` 'auto', nullable
  - `safety_identifier` string, nullable
  - `service_tier` 'default'
  - `status` 'completed' | 'incomplete' | 'failed'
  - `store` boolean, required
  - `temperature` number, required
  - `text` object
    - `format` object
      - `type` 'text'
  - `tool_choice` union, required
    - 'auto' | 'none' | 'required'
    - object
      - `name` string, required
      - `type` 'function', required
    - object
      - `type` 'quiver:svg_generation' | 'quiver:svg_vectorization' | 'quiver:svg_animation' | 'quiver:svg_editing' | 'quiver:style_creation' | 'quiver:icon_generation' | 'quiver:icon_editing' | 'quiver:font_generation' | 'quiver:font_glyph_editing' | 'quiver:font_expansion' | 'quiver:font_export', required
    - object
      - `mode` 'auto' | 'required', required
      - `tools` union[], required
        - union
          - object
            - `name` string, required
            - `type` 'function', required
          - object
            - `type` 'quiver:svg_generation' | 'quiver:svg_vectorization' | 'quiver:svg_animation' | 'quiver:svg_editing' | 'quiver:style_creation' | 'quiver:icon_generation' | 'quiver:icon_editing' | 'quiver:font_generation' | 'quiver:font_glyph_editing' | 'quiver:font_expansion' | 'quiver:font_export', required
      - `type` 'allowed_tools', required
  - `tools` union[]
    - union
      - object
        - `attributes` object, nullable
        - `auto_crop` boolean, nullable
        - `n` integer, nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `sRef` string, nullable
        - `settings` object, nullable
          - `aspect_ratio` string, nullable
          - `instructions` string, nullable
          - `max_output_tokens` integer, nullable
          - `presence_penalty` number, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
          - `top_p` number, nullable
        - `style` object, nullable
          - `attributes` object, nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `type` 'quiver:svg_generation', required
      - object
        - `attributes` object, nullable
        - `auto_crop` boolean, nullable
        - `image` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `max_output_tokens` integer, nullable
        - `presence_penalty` number, nullable
        - `target_size` integer, nullable
        - `temperature` number, nullable
        - `top_p` number, nullable
        - `type` 'quiver:svg_vectorization', required
      - object
        - `prompt` string, nullable
        - `settings` object, nullable
          - `max_output_tokens` integer, nullable
          - `temperature` number, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:svg_animation', required
      - object
        - `max_review_steps` integer
        - `prompt` string, nullable
        - `reference_images` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `settings` object, nullable
          - `max_output_tokens` integer, nullable
          - `orchestrator_max_output_tokens` integer, nullable
          - `shallow_max_output_tokens` integer, nullable
          - `temperature` number, nullable
        - `svg` string, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:svg_editing', required
      - object
        - `attributes` object, nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:style_creation', required
      - object
        - `attributes` object, nullable
        - `auto_crop` boolean, nullable
        - `prompt` string, nullable
        - `sRef` string, nullable
        - `settings` object, nullable
          - `aspect_ratio` string, nullable
          - `instructions` string, nullable
          - `max_output_tokens` integer, nullable
          - `presence_penalty` number, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
          - `top_p` number, nullable
        - `style` object, nullable
          - `attributes` object, nullable
          - `prompt` string, nullable
          - `references` object[], nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
        - `subjects` object[], nullable
          - `image` object, nullable
            - `base64` string, nullable
            - `ref` string, nullable
            - `url` string, nullable
          - `text` string, required
        - `type` 'quiver:icon_generation', required
      - object
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `sRef` string, nullable
        - `settings` object, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:icon_editing', required
      - object
        - `glyph_set` '36' | '72' | 'null', nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `settings` object, nullable
          - `seed` integer, nullable
        - `skip_ttf` boolean, nullable
        - `type` 'quiver:font_generation', required
      - object
        - `glyph_name` string, nullable
        - `prompt` string, nullable
        - `references` object[], nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `settings` object, nullable
          - `seed` integer, nullable
          - `temperature` number, nullable
        - `svg_source` object, nullable
          - `base64` string, nullable
          - `ref` string, nullable
          - `url` string, nullable
        - `type` 'quiver:font_glyph_editing', required
      - object
        - `glyph_set` 'ascii_basic_36_extension' | 'ascii_extra_symbols_1' | 'ascii_extra_symbols_2' | 'null', nullable
        - `settings` object, nullable
          - `seed` integer, nullable
        - `ttf_base64` string, nullable
        - `type` 'quiver:font_expansion', required
      - object
        - `font_name` string, nullable
        - `format` 'ttf', nullable
        - `lax_export` boolean, nullable
        - `svgs` object, nullable
        - `type` 'quiver:font_export', required
      - object
        - `description` string, nullable
        - `name` string, required
        - `parameters` object, nullable, required
        - `strict` boolean, nullable, required
        - `type` 'function', required
  - `top_logprobs` integer
  - `top_p` number, required
  - `truncation` 'disabled'
  - `usage` object, nullable
    - `input_tokens` integer, required
    - `input_tokens_details` object, required
      - `cache_write_tokens` integer, required
      - `cached_tokens` integer, required
    - `output_tokens` integer, required
    - `output_tokens_details` object, required
      - `reasoning_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `400` — Bad request – malformed body, missing required fields, or invalid parameter values.
- `401` — Unauthorized – missing, malformed, revoked, otherwise invalid API credentials, or an organization that could not be resolved for billing.
- `402` — Payment required – the organization has insufficient credits.
- `403` — Forbidden – the account is frozen, the request is not allowed, or content policy rejected the request.
- `404` — Not found – the requested model does not exist.
- `408` — Request timeout – the request exceeded an allowed client-facing deadline.
- `413` — Payload too large – the submitted prompt, image, or SVG input is too large.
- `429` — Rate limit exceeded – request throughput or measured input/output token usage exhausted a binding ceiling. `operation_rate_limit_exceeded` identifies operation throughput; `rate_limit_exceeded` covers overall request and token rates. `X-RateLimit-Dimension` names the exact dimension. When `Retry-After` is present, retry after the indicated period.
- `500` — The request could not be completed. Please retry.
- `502` — Bad gateway – model execution returned an invalid or failed response.
- `503` — Service unavailable – model execution is temporarily unavailable.
- `504` — Gateway timeout – model execution exceeded the server deadline.

## Changes

- **2026-09-02** `c042f10696f7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/quiver/apis/quiverai-api/changes/v1/responses/post.md)

---

[API](https://skmtc.dev/quiver/apis/quiverai-api.md) · [All operations](https://skmtc.dev/quiver/apis/quiverai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quiver/quiverai-api/revisions/c042f10696f7/schema)