changedInput schema / properties / fields / description
Previous value: -"PascalCase leaf piece name(s) to get value statistics for — an empty list is rejected, not treated as \"every field\". A group of fields (LeadSponsor, ConditionMesh) is refused with its leaf pieces named (LeadSponsorName, ConditionMeshTerm), and a full path as clinicaltrials_get_field_definitions prints it (\"protocolSection.statusModule.overallStatus\") is read as its piece name. A comma- or pipe-joined string (\"Phase,StudyType\") is split into separate names. Examples: OverallStatus, Phase, StudyType, Sex, LeadSponsorClass. Use clinicaltrials_get_field_definitions with a query to find more field names."New value: +"PascalCase leaf piece name(s) to get value statistics for — an empty list is rejected, not treated as \"every field\". Index-only pieces count too (NumLocations, StudyFirstPostYear — listed by clinicaltrials_get_field_definitions in drill mode with includeIndexedOnly), as do legacy alt names such as OVERALL-STATUS; a search area such as ConditionSearch does not. A group of fields (LeadSponsor, ConditionMesh) is refused with its leaf pieces named (LeadSponsorName, ConditionMeshTerm), and a full path as clinicaltrials_get_field_definitions prints it (\"protocolSection.statusModule.overallStatus\") is read as its piece name. A comma- or pipe-joined string (\"Phase,StudyType\") is split into separate names. Examples: OverallStatus, Phase, StudyType, Sex, LeadSponsorClass. Use clinicaltrials_get_field_definitions with a query to find more field names."
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `blank_value`: A parameter was supplied with a blank, whitespace-only, or empty-list value. `field_invalid`: A requested name is not a field, names a group of fields such as LeadSponsor or ConditionMesh instead of its leaf pieces, or names a leaf whose type ClinicalTrials.gov does not count, such as LocationGeoPoint. `request_too_long`: The fields list makes the request URL longer than ClinicalTrials.gov accepts — a few hundred piece names in one call. `rate_limited`: ClinicalTrials.gov answered HTTP 429 on every attempt, or the call’s time budget ran out after a 429. `retry_deadline_exceeded`: ClinicalTrials.gov did not answer within the call’s time budget, which covers every request, retry, and wait the call makes. `upstream_timeout`: ClinicalTrials.gov answered HTTP 504 (gateway timeout) on every attempt. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `blank_value`: A parameter was supplied with a blank, whitespace-only, or empty-list value. `field_invalid`: A requested name is not a field (a record or index-only piece such as NumLocations, or an alt name of one; a search area such as ConditionSearch is not), names a group of fields such as LeadSponsor or ConditionMesh instead of its leaf pieces, or names a leaf whose type ClinicalTrials.gov does not count, such as LocationGeoPoint. `request_too_long`: The fields list makes the request URL longer than ClinicalTrials.gov accepts — a few hundred piece names in one call. `rate_limited`: ClinicalTrials.gov answered HTTP 429 on every attempt, or the call’s time budget ran out after a 429. `retry_deadline_exceeded`: ClinicalTrials.gov did not answer within the call’s time budget, which covers every request, retry, and wait the call makes. `upstream_timeout`: ClinicalTrials.gov answered HTTP 504 (gateway timeout) or 408 (request timeout), or sent no answer within the per-attempt timeout, on every attempt. `upstream_unavailable`: Every attempt failed on ClinicalTrials.gov’s side — HTTP 500, 502, or 503, a dropped connection or one the network gave up opening, or a 200 body that is not the JSON the route serves (an HTML page, unparseable text, the wrong shape) — or it answered with another 5xx, such as 505, or the connection was refused or its host name did not resolve, none of which is retried. `upstream_rejected`: ClinicalTrials.gov refused the request with a status its API does not use for a bad query — HTTP 501, a 3xx, or a 4xx such as 401, 403, or 410 — or answered with an HTML error page in place of its own 404. Other values are possible when a failure originates below the handler."
changedOutput schema / properties / error / properties / data / properties / reason / examples
Previous value: -[
- "blank_value",
- "field_invalid",
- "request_too_long",
- "rate_limited",
- "retry_deadline_exceeded",
- "upstream_timeout"
-]New value: +[
+ "blank_value",
+ "field_invalid",
+ "request_too_long",
+ "rate_limited",
+ "retry_deadline_exceeded",
+ "upstream_timeout",
+ "upstream_unavailable",
+ "upstream_rejected"
+]
changedOutput schema / properties / fieldStats / items / properties / multiValued / description
Previous value: -"True when the field is repeated — array-typed itself (Phase, Condition) or nested under a repeated object (LocationCountry, one per site) — so a study can carry several values and the per-value studiesCount buckets sum above the study total. Use to avoid computing a percentage against the corpus."New value: +"True when the field is repeated — array-typed itself (Phase, Condition) or nested under a repeated object (LocationCountry, one per site) — so a study can carry several values and the per-value studiesCount buckets sum above the study total. Use to avoid computing a percentage against the corpus. Absent for a single-valued field, and for any field the notice names as not determined."
changedOutput schema / properties / notice / description
Previous value: -"Present when a longest value was cut to a preview — names, for each such field, the clinicaltrials_search_studies arguments that return its full text."New value: +"Present when a longest value was cut to a preview — names, for each such field, the clinicaltrials_search_studies arguments that return its full text — or when multiValued could not be determined for a field, which then carries no multiValued flag and may be repeated."