Public read: capabilities discovers IDs and context vocabulary; candidates finds IDs for a priority; compare compares 2–3 IDs; specification reads one dossier. Same operation/input with representation detail, transport.resume and reference reads a snapshot field or page. On 409 restart summary. No account or writes. Sources, unknowns and dated limits remain explicit. Read the single JSON content.text Outcome (no structuredContent). A compact capabilities index keeps every ID, label and value_type; read its detail.field for definition, enum_values, units and scope before constructing a priority. Candidate priority operators by discovered value_type: boolean equals true only; quantity (integer) or amount ({minor,currency,tax_basis}) equals, at_least, at_most; set equals, or contains with a nonempty array; enum equals a member of enum_values. Text is not a candidate priority. Use the request schema for required keys and vocabularies for values; comparison_rule does not define priority operators or imply superiority.
View input schema
{
"type": "object",
"properties": {
"operation": {
"enum": [
"capabilities",
"specification",
"compare",
"candidates"
],
"type": "string"
},
"input": {
"type": "object"
},
"representation": {
"enum": [
"summary",
"detail"
],
"default": "summary",
"type": "string"
},
"resume": {
"type": "object",
"properties": {
"evaluated_at": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d\\.\\d{3}Z$",
"format": "date-time"
},
"dataset_id": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"snapshot_id": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"request_id": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"evaluated_at",
"dataset_id",
"snapshot_id",
"request_id"
],
"additionalProperties": false
},
"reference": {
"type": "object",
"properties": {
"field": {
"type": "string",
"maxLength": 4096,
"pattern": "^(?:/(?:[^~]|~[01])*)?$",
"description": "RFC6901; <=64 segments; unsafe object keys forbidden."
},
"view": {
"type": "object",
"properties": {
"result_id": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"field": {
"type": "string",
"maxLength": 4096,
"pattern": "^(?:|/(?:[^~]|~[01])*)$"
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 999999
}
},
"required": [
"result_id",
"field",
"offset"
],
"additionalProperties": false
}
},
"required": [
"field"
],
"additionalProperties": false
}
},
"required": [
"operation"
],
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"operation": {
"const": "capabilities",
"type": "string"
}
}
},
"then": {
"properties": {
"input": {
"$ref": "#/$defs/CapabilitiesInput",
"type": "object"
}
}
}
},
{
"if": {
"properties": {
"operation": {
"const": "specification",
"type": "string"
}
}
},
"then": {
"properties": {
"input": {
"$ref": "#/$defs/SpecificationInput",
"type": "object"
}
},
"required": [
"input"
]
}
},
{
"if": {
"properties": {
"operation": {
"const": "compare",
"type": "string"
}
}
},
"then": {
"properties": {
"input": {
"$ref": "#/$defs/CompareInput",
"type": "object"
}
},
"required": [
"input"
]
}
},
{
"if": {
"properties": {
"operation": {
"const": "candidates",
"type": "string"
}
}
},
"then": {
"properties": {
"input": {
"$ref": "#/$defs/CandidatesInput",
"type": "object"
}
},
"required": [
"input"
]
}
},
{
"if": {
"required": [
"representation"
],
"properties": {
"representation": {
"const": "detail",
"type": "string"
}
}
},
"then": {
"required": [
"resume",
"reference"
]
},
"else": {
"not": {
"anyOf": [
{
"required": [
"resume"
]
},
{
"required": [
"reference"
]
}
]
}
}
}
],
"$defs": {
"Id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[a-z0-9][a-z0-9._-]*$"
},
"Count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"Predicate": {
"type": "object",
"properties": {
"capability_id": {
"$ref": "#/$defs/Id"
},
"operator": {
"enum": [
"equals",
"at_least",
"at_most",
"contains"
]
},
"value": {
"anyOf": [
{
"type": [
"boolean",
"string",
"integer"
]
},
{
"type": "array",
"items": {
"$ref": "#/$defs/Id"
},
"maxItems": 20,
"minItems": 1,
"uniqueItems": true
},
{
"type": "object",
"properties": {
"minor": {
"$ref": "#/$defs/Count"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"tax_basis": {
"enum": [
"excluding_tax",
"including_tax"
]
}
},
"required": [
"minor",
"currency",
"tax_basis"
],
"additionalProperties": false
}
]
}
},
"required": [
"capability_id",
"operator",
"value"
],
"additionalProperties": false
},
"Scenario": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"tax_basis": {
"enum": [
"excluding_tax",
"including_tax"
]
},
"users": {
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"start_date": {
"type": "string",
"format": "date"
},
"horizon_months": {
"type": "integer",
"minimum": 1,
"maximum": 36
},
"max_commitment_months": {
"type": "integer",
"minimum": 1,
"maximum": 36
},
"billing_periods": {
"type": "array",
"items": {
"enum": [
"monthly",
"yearly"
]
},
"maxItems": 2,
"minItems": 1,
"uniqueItems": true
},
"allow_current_price_projection": {
"type": "boolean"
},
"usage": {
"type": "object",
"maxProperties": 10,
"propertyNames": {
"$ref": "#/$defs/Id"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000
},
"maxItems": 36,
"minItems": 1
}
}
},
"required": [
"currency",
"tax_basis",
"users",
"start_date",
"horizon_months",
"max_commitment_months",
"billing_periods",
"allow_current_price_projection",
"usage"
],
"additionalProperties": false
},
"Context": {
"type": "object",
"properties": {
"market": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{2}$"
},
{
"type": "null"
}
]
},
"audience": {
"anyOf": [
{
"$ref": "#/$defs/Id"
},
{
"type": "null"
}
]
},
"activity": {
"anyOf": [
{
"$ref": "#/$defs/Id"
},
{
"type": "null"
}
]
},
"tax_regime": {
"anyOf": [
{
"$ref": "#/$defs/Id"
},
{
"type": "null"
}
]
},
"channel": {
"anyOf": [
{
"enum": [
"ui",
"api",
"mcp"
]
},
{
"type": "null"
}
]
},
"deployment": {
"anyOf": [
{
"enum": [
"cloud",
"self_hosted",
"desktop",
"mobile"
]
},
{
"type": "null"
}
]
},
"version": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
]
}
},
"required": [],
"additionalProperties": false
},
"ComparisonView": {
"type": "object",
"properties": {
"result_id": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"field": {
"type": "string",
"maxLength": 4096,
"pattern": "^(?:|/(?:[^~]|~[01])*)$"
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 999999
}
},
"required": [
"result_id",
"field",
"offset"
],
"additionalProperties": false
},
"CapabilitiesInput": {
"type": "object",
"properties": {
"process": {
"type": "string"
},
"locale": {
"enum": [
"fr",
"en"
],
"type": "string"
}
},
"required": [],
"additionalProperties": false
},
"SpecificationInput": {
"type": "object",
"properties": {
"solution_id": {
"$ref": "#/$defs/Id",
"type": "string"
},
"locale": {
"enum": [
"fr",
"en"
],
"type": "string"
}
},
"required": [
"solution_id"
],
"additionalProperties": false
},
"CompareInput": {
"type": "object",
"properties": {
"solution_ids": {
"type": "array",
"items": {
"$ref": "#/$defs/Id"
},
"maxItems": 3,
"minItems": 2,
"uniqueItems": true
},
"priority": {
"anyOf": [
{
"$ref": "#/$defs/Predicate"
},
{
"type": "null"
}
]
},
"priority_required": {
"type": "boolean"
},
"criteria": {
"type": "array",
"items": {
"$ref": "#/$defs/Id"
},
"maxItems": 20,
"minItems": 0,
"uniqueItems": true
},
"requirements": {
"type": "array",
"items": {
"$ref": "#/$defs/Predicate"
},
"maxItems": 20,
"minItems": 0,
"uniqueItems": true
},
"context": {
"type": "object",
"$ref": "#/$defs/Context"
},
"cost_scenario": {
"anyOf": [
{
"$ref": "#/$defs/Scenario"
},
{
"type": "null"
}
]
},
"locale": {
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"required": [
"solution_ids"
],
"additionalProperties": false
},
"CandidatesInput": {
"type": "object",
"properties": {
"reference_id": {
"anyOf": [
{
"$ref": "#/$defs/Id"
},
{
"type": "null"
}
]
},
"priority": {
"type": "object",
"$ref": "#/$defs/Predicate"
},
"criteria": {
"type": "array",
"items": {
"$ref": "#/$defs/Id"
},
"maxItems": 20,
"minItems": 0,
"uniqueItems": true
},
"requirements": {
"type": "array",
"items": {
"$ref": "#/$defs/Predicate"
},
"maxItems": 20,
"minItems": 0,
"uniqueItems": true
},
"context": {
"type": "object",
"$ref": "#/$defs/Context"
},
"cost_scenario": {
"anyOf": [
{
"$ref": "#/$defs/Scenario"
},
{
"type": "null"
}
]
},
"locale": {
"type": "string",
"enum": [
"en",
"fr"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5
}
},
"required": [
"priority"
],
"additionalProperties": false
}
}
}