EconomicoReusable schemas and security schemes
All operations. Resolve local $ref values against these components.
{
"schemas": {
"Error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"hint": {
"type": "string"
},
"details": {}
}
},
"Publisher": {
"type": "object",
"properties": {
"kind": {
"enum": [
"economico",
"business"
]
},
"name": {
"type": "string"
},
"did": {
"type": "string"
},
"domainVerified": {
"type": "boolean"
},
"domainClaim": {
"type": "object"
}
},
"required": [
"kind",
"name"
]
},
"EntryMatch": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"shelf": {
"enum": [
"vendors",
"standard-agreements",
"patterns"
]
},
"name": {
"type": "string"
},
"publisher": {
"$ref": "#/components/schemas/Publisher"
},
"matchedOn": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"key": {
"type": "string"
}
},
"required": [
"kind",
"key"
]
},
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
}
},
"required": [
"slug",
"shelf",
"name",
"publisher",
"matchedOn",
"cid"
]
},
"Entry": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"shelf": {
"type": "string"
},
"name": {
"type": "string"
},
"publisher": {
"$ref": "#/components/schemas/Publisher"
},
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"status": {
"enum": [
"listed",
"withdrawn"
]
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"domains": {
"type": "array",
"items": {
"type": "string"
}
},
"entities": {
"type": "array",
"items": {
"type": "object"
}
},
"channels": {
"type": "object"
},
"matching": {
"type": "object"
},
"classificationHints": {
"type": "object"
}
},
"required": [
"slug",
"shelf",
"name",
"publisher",
"cid",
"status"
]
},
"PlanSummary": {
"type": "object",
"properties": {
"planKey": {
"type": "string"
},
"name": {
"type": "string"
},
"channel": {
"type": "string"
},
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"effectiveFrom": {
"type": "string",
"format": "date"
},
"readOn": {
"type": "string"
},
"status": {
"enum": [
"offered",
"not_offered"
]
},
"evidence": {
"enum": [
"illustrative",
"invoice-verified"
]
},
"templates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"key",
"name"
]
}
},
"minSchema": {
"type": "integer"
}
},
"required": [
"planKey",
"name",
"cid",
"effectiveFrom",
"status",
"evidence",
"templates"
]
},
"GalleryPlan": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"planKey": {
"type": "string"
},
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"gallery": {
"type": "object"
}
},
"required": [
"slug",
"planKey",
"cid",
"gallery"
]
},
"VersionStatus": {
"type": "object",
"properties": {
"state": {
"enum": [
"offered",
"not_offered",
"withdrawn"
]
},
"notOfferedSince": {
"type": "string"
},
"withdrawn": {
"type": "object"
}
},
"required": [
"state"
]
},
"Revision": {
"type": "object",
"properties": {
"kind": {
"enum": [
"change",
"correction"
]
},
"summary": {
"type": "string"
},
"correctsFrom": {
"type": "string"
}
},
"required": [
"kind",
"summary"
]
},
"VersionSummary": {
"type": "object",
"properties": {
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"effectiveFrom": {
"type": "string"
},
"readOn": {
"type": "string"
},
"revision": {
"$ref": "#/components/schemas/Revision"
},
"supersedes": {
"type": [
"string",
"null"
]
},
"supersededBy": {
"type": [
"string",
"null"
]
},
"current": {
"type": "boolean"
},
"evidence": {
"type": "string"
},
"status": {
"$ref": "#/components/schemas/VersionStatus"
}
},
"required": [
"cid",
"effectiveFrom",
"status"
]
},
"Supersession": {
"type": "object",
"properties": {
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"known": {
"type": "boolean"
},
"status": {
"$ref": "#/components/schemas/VersionStatus"
},
"next": {
"type": [
"object",
"null"
]
},
"current": {
"type": [
"object",
"null"
]
},
"error": {
"type": "object"
}
},
"required": [
"cid",
"known"
]
},
"AgreementVersion": {
"type": "object",
"properties": {
"cid": {
"type": [
"string",
"null"
]
},
"recordCid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"doc": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"versionUrl": {
"type": [
"string",
"null"
]
},
"label": {
"type": "object"
},
"seenAt": {
"type": "string"
},
"method": {
"type": "object"
},
"history": {
"type": "object"
},
"governs": {
"type": "array",
"items": {
"type": "string"
}
},
"incorporates": {
"type": "array",
"items": {
"type": "string"
}
},
"rules": {
"type": "object"
},
"changed": {
"type": [
"object",
"null"
]
},
"revision": {
"type": "object",
"properties": {
"kind": {
"enum": [
"change",
"correction"
]
},
"summary": {
"type": "string"
},
"effectiveFrom": {
"type": "string"
}
},
"required": [
"kind",
"summary",
"effectiveFrom"
]
},
"supersedes": {
"type": [
"object",
"string",
"null"
]
},
"current": {
"type": "boolean"
}
},
"required": [
"cid",
"recordCid",
"doc",
"title",
"url",
"label",
"seenAt",
"method",
"current"
]
},
"CatalogDocument": {
"type": "object",
"properties": {
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"kind": {
"enum": [
"entry",
"vendor_plan",
"source",
"agreement"
]
},
"document": {
"type": "object",
"description": "Immutable for this cid. vendor_plan: vendor, publisher, planKey, name, effectiveFrom, readOn, revision, bundle and the cited source records; otherwise the parsed record."
},
"current": {
"type": "object",
"properties": {
"status": {
"$ref": "#/components/schemas/VersionStatus"
},
"evidence": {
"enum": [
"illustrative",
"invoice-verified"
]
},
"supersession": {
"$ref": "#/components/schemas/Supersession"
},
"agreements": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AgreementVersion"
}
}
},
"required": [
"status",
"evidence",
"supersession",
"agreements"
],
"description": "vendor_plan only, read fresh: sale state, evidence level (which a later real invoice replay can raise), supersession and the governing agreements in force."
}
},
"required": [
"cid",
"kind",
"document"
]
},
"Publication": {
"type": "object",
"properties": {
"cid": {
"type": "string",
"description": "CIDv1 raw blake3 over exact stored bytes"
},
"name": {
"type": "string"
},
"planKey": {
"type": "string"
},
"publisher": {
"$ref": "#/components/schemas/Publisher"
},
"slug": {
"type": "string"
},
"domainVerified": {
"type": "boolean"
},
"status": {
"enum": [
"published",
"withdrawn"
]
},
"at": {
"type": "string"
}
},
"required": [
"cid",
"name",
"planKey",
"publisher",
"slug",
"domainVerified",
"status",
"at"
]
}
},
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"description": "Opaque OAuth or headless JWT token bound to https://economi.co/mcp."
}
}
}