ChatGPT · Schema

ResponseObject

AgentsAIChatGPTEmbeddingsFine-TuningGPT-4GPT-5Language ModelOpenAIRealtime

Properties

Name	Type	Description
id	string	Unique identifier for the response.
object	string	The object type, always response.
created_at	integer	Unix timestamp (in seconds) of when the response was created.
model	string	The model used to generate the response.
status	string	The status of the response generation. One of completed, failed, in_progress, or incomplete.
output	array	An array of content items generated by the model. Can include messages, function calls, web search calls, file search calls, computer actions, and reasoning items.
usage	object
error	object	An error object if the response generation failed.
incomplete_details	object	Details about why the response is incomplete.
instructions	string	The instructions provided for the response.
metadata	object	Metadata attached to the response.
temperature	number	The sampling temperature used.
top_p	number	The nucleus sampling value used.
max_output_tokens	integer	The maximum output tokens setting.
previous_response_id	string	The ID of the previous response in the conversation.
reasoning	object	The reasoning configuration used.
text	object	The text format configuration used.
tools	array	The tools available during response generation.
tool_choice	object	The tool choice setting used.
truncation	string	The truncation strategy used.
user	string	The end-user identifier.
service_tier	string	The service tier used.

View JSON Schema on GitHub

JSON Schema

{
  "$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"
    }
  }
}