{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aiand-com/json-schema/aiand-com-create-response-response-schema.json",
  "title": "CreateResponseResponse",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aiand-com-openapi.json#/components/schemas/CreateResponseResponse",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for this response."
    },
    "object": {
      "type": "string",
      "const": "response",
      "description": "The object type — always \"response\"."
    },
    "status": {
      "type": "string",
      "enum": [
        "completed",
        "failed",
        "in_progress",
        "cancelled",
        "queued",
        "incomplete"
      ],
      "description": "The status of the response generation."
    },
    "created_at": {
      "type": "number",
      "description": "Unix timestamp (in seconds) of when this response was created."
    },
    "completed_at": {
      "type": [
        "number",
        "null"
      ],
      "description": "Unix timestamp of completion. Only present when status is completed."
    },
    "model": {
      "type": "string",
      "description": "The model used to generate the response."
    },
    "output": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "const": "message"
              },
              "role": {
                "type": "string",
                "const": "assistant"
              },
              "status": {
                "type": "string",
                "enum": [
                  "in_progress",
                  "completed",
                  "incomplete"
                ]
              },
              "content": {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "output_text"
                        },
                        "text": {
                          "type": "string"
                        },
                        "annotations": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          }
                        }
                      },
                      "required": [
                        "type",
                        "text"
                      ],
                      "additionalProperties": true
                    },
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "refusal"
                        },
                        "refusal": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "refusal"
                      ]
                    }
                  ]
                }
              }
            },
            "required": [
              "id",
              "type",
              "role",
              "status",
              "content"
            ],
            "additionalProperties": true
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "const": "function_call"
              },
              "call_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "arguments": {
                "type": "string"
              },
              "status": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "type",
              "call_id",
              "name",
              "arguments"
            ],
            "additionalProperties": true
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "const": "reasoning"
              },
              "summary": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            },
            "required": [
              "id",
              "type"
            ],
            "additionalProperties": true
          }
        ]
      },
      "description": "An array of content items generated by the model."
    },
    "error": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "description": "Error details if the response generation failed."
    },
    "incomplete_details": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "reason": {
          "type": "string",
          "enum": [
            "max_output_tokens",
            "content_filter"
          ]
        }
      },
      "required": [
        "reason"
      ],
      "description": "Details about why the response is incomplete."
    },
    "instructions": {
      "type": [
        "string",
        "null"
      ]
    },
    "metadata": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": "string"
      }
    },
    "temperature": {
      "type": [
        "number",
        "null"
      ]
    },
    "top_p": {
      "type": [
        "number",
        "null"
      ]
    },
    "max_output_tokens": {
      "type": [
        "integer",
        "null"
      ]
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "tool_choice": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "additionalProperties": true
        }
      ]
    },
    "parallel_tool_calls": {
      "type": "boolean"
    },
    "truncation": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "auto",
        "disabled",
        null
      ]
    },
    "previous_response_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "reasoning": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "effort": {
          "type": "string",
          "enum": [
            "none",
            "minimal",
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ]
        },
        "summary": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "auto",
            "concise",
            "detailed",
            null
          ]
        }
      }
    },
    "text": {
      "type": "object",
      "additionalProperties": true
    },
    "top_logprobs": {
      "type": [
        "integer",
        "null"
      ]
    },
    "usage": {
      "$ref": "#/$defs/ResponseUsage",
      "description": "Token usage details for this response."
    }
  },
  "required": [
    "id",
    "object",
    "status",
    "created_at",
    "model",
    "output"
  ],
  "additionalProperties": true,
  "$defs": {
    "ResponseUsage": {
      "type": "object",
      "properties": {
        "input_tokens": {
          "type": "integer"
        },
        "output_tokens": {
          "type": "integer"
        },
        "total_tokens": {
          "type": "integer"
        },
        "input_tokens_details": {
          "type": "object",
          "properties": {
            "cached_tokens": {
              "type": "integer"
            }
          },
          "required": [
            "cached_tokens"
          ],
          "additionalProperties": true
        },
        "output_tokens_details": {
          "type": "object",
          "properties": {
            "reasoning_tokens": {
              "type": "integer"
            }
          },
          "required": [
            "reasoning_tokens"
          ],
          "additionalProperties": true
        }
      },
      "required": [
        "input_tokens",
        "output_tokens",
        "total_tokens"
      ]
    }
  }
}