Raw schema
{
"type": "object",
"properties": {
"urls": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "string",
"format": "uri",
"maxLength": 4096
},
"description": "Public HTTPS URLs to check, 1-10, in order, without quotations. Each uses the guarded Source Reader: robots.txt is respected, at most three redirects are followed, and scripts are not run."
},
"citations": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"description": "1–10 citations in result order. Use url with optional quote, or source_id with required quote. Repeated URLs share a retrieval; source_id references reuse the supplied text. Optional citation ids must be unique.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 4096
},
"quote": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "The exact words attributed to this source."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Optional non-blank citation identifier, unique within the batch; echoed unchanged on success and failure."
},
"source_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "References an id in sources. Use exactly one of url or source_id; source_id requires quote. No URL is fetched for this entry."
}
},
"oneOf": [
{
"required": [
"url"
],
"not": {
"required": [
"source_id"
]
}
},
{
"required": [
"source_id",
"quote"
],
"not": {
"required": [
"url"
]
}
}
]
}
},
"sources": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"description": "Optional caller-supplied sources, only with citations. Refer to each by source_id. No URL provenance is accepted or verified. The entire request must fit within 64 KiB.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"source_text"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Non-blank source identifier, unique in sources."
},
"source_text": {
"type": "string",
"minLength": 1,
"maxLength": 100000,
"description": "Non-blank text checked literally, preserving original whitespace and offsets. Share it across citations instead of repeating the text. No markup removal, fetching, or code execution."
},
"source_truncated": {
"type": "boolean",
"default": false,
"description": "Set true for an excerpt or incomplete source. A missing quotation is then inconclusive for the complete source."
}
}
}
}
},
"additionalProperties": false,
"description": "Supply exactly one of urls or citations. Optional sources requires citations; source_id references must exist and supplied-text citations require quote. Source IDs and citation IDs must each be unique in their own list."
}