Input schema (JSON)
{
"type": "object",
"examples": [
{
"citations": [
{
"url": "https://www.gaipagents.com/",
"quote": "GAIP"
}
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Claims: the agent or supplier they are about. Delivery: the public https service URL that should deliver."
},
"checks": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"enum": [
"http_status_in",
"content_type_is",
"non_empty",
"json_parses",
"json_required_keys",
"json_path_equals",
"max_latency_ms",
"max_bytes",
"text_contains",
"regex"
],
"type": "string",
"description": "http_status_in (allowed), content_type_is (value), non_empty, json_parses, json_required_keys (keys), json_path_equals (path, value), max_latency_ms (limit), max_bytes (limit), text_contains (value), regex (pattern)."
},
"keys": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 20,
"minItems": 1,
"description": "json_required_keys: top-level or dotted keys that must exist, e.g. [\"a.b\"]."
},
"path": {
"type": "string",
"maxLength": 200,
"description": "json_path_equals: dotted path, list items by index, e.g. items.0.id."
},
"limit": {
"type": "integer",
"maximum": 60000,
"minimum": 1,
"description": "max_latency_ms: milliseconds (1-60000); max_bytes: body bytes (1-32768)."
},
"value": {
"type": "string",
"maxLength": 200,
"description": "content_type_is: media type, e.g. application/json; text_contains: case-sensitive text; json_path_equals: the expected value (GAIP also accepts a number, boolean, null, array or object)."
},
"allowed": {
"type": "array",
"items": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"maxItems": 10,
"minItems": 1,
"description": "http_status_in: the acceptable HTTP statuses, e.g. [200]."
},
"pattern": {
"type": "string",
"maxLength": 200,
"description": "regex: bounded pattern searched in the body; no nested quantifiers."
}
},
"additionalProperties": false
},
"examples": [
[
{
"id": "http_status_in",
"allowed": [
200
]
},
{
"id": "content_type_is",
"value": "application/json"
},
{
"id": "non_empty"
},
{
"id": "json_parses"
}
],
[
{
"id": "http_status_in",
"allowed": [
200
]
},
{
"id": "json_required_keys",
"keys": [
"status"
]
},
{
"id": "json_path_equals",
"path": "status",
"value": "ok"
},
{
"id": "max_latency_ms",
"limit": 2000
}
]
],
"maxItems": 8,
"minItems": 1,
"description": "Optional (delivery): what a good response is, e.g. [{\"id\": \"http_status_in\", \"allowed\": [200]}, {\"id\": \"json_parses\"}]. Default: HTTP 200 and a non-empty body."
},
"claims": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
]
},
"maxItems": 20,
"minItems": 1,
"description": "Claims to record about `url`: each a sentence or {id, text}. Each is compared with the `observations` you supply; without them it stays UNTESTED."
},
"result": {
"type": "object",
"properties": {
"body": {
"type": "string",
"maxLength": 32768
},
"body_sha256": {
"type": "string"
},
"http_status": {
"type": "integer"
},
"content_type": {
"type": "string"
}
},
"description": "Optional (delivery): the response you received. Omitted: GAIP fetches the service URL now (public replay)."
},
"verbose": {
"type": "boolean",
"default": false,
"description": "Optional: true returns the full result with every underlying field. Default: a short answer."
},
"metadata": {
"type": "object",
"description": "Optional (claims): the published agent card, MCP or OpenAPI document."
},
"terms_id": {
"type": "string",
"description": "Optional (delivery): terms_id from an earlier registration, instead of url."
},
"citations": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
]
},
"maxItems": 20,
"minItems": 1,
"description": "Citations to check: each {url, quote?} or just a URL. GAIP fetches each page once (robots.txt respected) and looks for the quote."
},
"keep_receipt": {
"type": "boolean",
"default": false,
"description": "Optional: true keeps a dated GAIP receipt of this answer and returns a continuity handle. Default: GAIP keeps no record of the task (usage is counted without its content)."
},
"observations": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 30,
"description": "Optional (claims): what you saw, each {claim_id, result: PASS|FAIL, detail}."
},
"continuity_handle": {
"type": "object",
"required": [
"continuity_id",
"token"
],
"properties": {
"token": {
"type": "string"
},
"continuity_id": {
"type": "string"
}
},
"description": "Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones (needed to see or remove your watches later).",
"additionalProperties": false
}
},
"additionalProperties": false
}