{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ResponseObject",
  "title": "ResponseObject",
  "type": "object",
  "required": [
    "id",
    "object",
    "created_at",
    "model",
    "status",
    "output",
    "usage"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the response.",
      "example": "abc123"
    },
    "object": {
      "type": "string",
      "description": "The object type, always response.",
      "enum": [
        "response"
      ],
      "example": "response"
    },
    "created_at": {
      "type": "integer",
      "description": "Unix timestamp (in seconds) of when the response was created.\n",
      "example": "2026-01-15T10:30:00Z"
    },
    "model": {
      "type": "string",
      "description": "The model used to generate the response.",
      "example": "example_value"
    },
    "status": {
      "type": "string",
      "description": "The status of the response generation. One of completed,\nfailed, in_progress, or incomplete.\n",
      "enum": [
        "completed",
        "failed",
        "in_progress",
        "incomplete"
      ],
      "example": "completed"
    },
    "output": {
      "type": "array",
      "description": "An array of content items generated by the model. Can\ninclude messages, function calls, web search calls,\nfile search calls, computer actions, and reasoning items.\n",
      "items": {
        "$ref": "#/components/schemas/ResponseOutputItem"
      },
      "example": []
    },
    "usage": {
      "$ref": "#/components/schemas/ResponseUsage"
    },
    "error": {
      "type": "object",
      "description": "An error object if the response generation failed.\n",
      "nullable": true,
      "properties": {
        "code": {
          "type": "string",
          "description": "The error code."
        },
        "message": {
          "type": "string",
          "description": "A human-readable error message."
        }
      },
      "example": "example_value"
    },
    "incomplete_details": {
      "type": "object",
      "description": "Details about why the response is incomplete.\n",
      "nullable": true,
      "properties": {
        "reason": {
          "type": "string",
          "description": "The reason the response is incomplete.",
          "enum": [
            "max_output_tokens",
            "content_filter"
          ]
        }
      },
      "example": "example_value"
    },
    "instructions": {
      "type": "string",
      "description": "The instructions provided for the response.",
      "nullable": true,
      "example": "example_value"
    },
    "metadata": {
      "type": "object",
      "description": "Metadata attached to the response.",
      "nullable": true,
      "additionalProperties": {
        "type": "string"
      },
      "example": "example_value"
    },
    "temperature": {
      "type": "number",
      "description": "The sampling temperature used.",
      "nullable": true,
      "example": 42.5
    },
    "top_p": {
      "type": "number",
      "description": "The nucleus sampling value used.",
      "nullable": true,
      "example": 42.5
    },
    "max_output_tokens": {
      "type": "integer",
      "description": "The maximum output tokens setting.",
      "nullable": true,
      "example": 10
    },
    "previous_response_id": {
      "type": "string",
      "description": "The ID of the previous response in the conversation.",
      "nullable": true,
      "example": "500123"
    },
    "reasoning": {
      "type": "object",
      "description": "The reasoning configuration used.",
      "nullable": true,
      "properties": {
        "effort": {
          "type": "string",
          "enum": [
            "low",
            "medium",
            "high"
          ]
        },
        "summary": {
          "type": "string",
          "nullable": true
        }
      },
      "example": "example_value"
    },
    "text": {
      "type": "object",
      "description": "The text format configuration used.",
      "nullable": true,
      "example": "example_value"
    },
    "tools": {
      "type": "array",
      "description": "The tools available during response generation.",
      "items": {
        "$ref": "#/components/schemas/ResponseTool"
      },
      "example": []
    },
    "tool_choice": {
      "description": "The tool choice setting used.",
      "example": "example_value"
    },
    "truncation": {
      "type": "string",
      "description": "The truncation strategy used.",
      "nullable": true,
      "example": "example_value"
    },
    "user": {
      "type": "string",
      "description": "The end-user identifier.",
      "nullable": true,
      "example": "example_value"
    },
    "service_tier": {
      "type": "string",
      "description": "The service tier used.",
      "nullable": true,
      "example": "example_value"
    }
  }
}