Properties
| Name | Type | Description |
|---|---|---|
| v | integer | |
| type | string | |
| record | object | |
| evidence | object | |
| platformKeys | array | |
| decryptedPayloads | object | Realignment R1 (docs/SPEC.md §13.3). visibility:"private" only, for an authorized (participant-owner) viewer. Decrypted fresh on every request — a pure addition, never folded into evidence itself, whi |
| contentDeleted | boolean | visibility:"private" only — set instead of decryptedPayloads once this record's content has been crypto-shredded (docs/SPEC.md §13.3). |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/openglass-glass/json-schema/openglass-glass-bundle-schema.json",
"title": "Bundle",
"x-generated": "2026-11-20",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/openglass-glass-openapi.yml#/components/schemas/Bundle",
"type": "object",
"required": [
"v",
"type",
"record",
"evidence",
"platformKeys"
],
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.bundle"
},
"record": {
"type": "object",
"required": [
"statement",
"statementHash",
"platformSignature"
],
"properties": {
"statement": {
"$ref": "#/$defs/RecordStatement"
},
"statementHash": {
"$ref": "#/$defs/Hash"
},
"platformSignature": {
"$ref": "#/$defs/Signature"
}
}
},
"evidence": {
"$ref": "#/$defs/Evidence"
},
"platformKeys": {
"type": "array",
"items": {
"$ref": "#/$defs/PlatformKey"
}
},
"decryptedPayloads": {
"description": "Realignment R1 (docs/SPEC.md §13.3). visibility:\"private\" only, for an authorized (participant-owner) viewer. Decrypted fresh on every request — a pure addition, never folded into evidence itself, which must stay exactly what was signed.",
"type": "object",
"additionalProperties": {}
},
"contentDeleted": {
"description": "visibility:\"private\" only — set instead of decryptedPayloads once this record's content has been crypto-shredded (docs/SPEC.md §13.3).",
"type": "boolean"
}
},
"$defs": {
"Accept": {
"type": "object",
"description": "Countersignature by the counterparty with purpose \"accept\" over H(JCS(accept)).",
"required": [
"v",
"type",
"sessionId",
"offerHash",
"counterparty",
"acceptedAt"
],
"additionalProperties": false,
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.accept"
},
"sessionId": {
"$ref": "#/$defs/SessionId"
},
"offerHash": {
"$ref": "#/$defs/Hash"
},
"counterparty": {
"$ref": "#/$defs/ParticipantKeyRef"
},
"acceptedAt": {
"$ref": "#/$defs/Timestamp"
}
}
},
"AgentId": {
"type": "string",
"pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$"
},
"AttestationId": {
"type": "string",
"pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$"
},
"AttestationOpen": {
"type": "object",
"description": "One-party counterpart to Offer+Accept (SPEC §12): signed by the attestor with purpose \"attestation_open\" over H(JCS(open)). Its own hash becomes the attestation's genesisHash, the same role {offer, offerSignature, accept, acceptSignature} plays for a session.",
"required": [
"v",
"type",
"attestationId",
"mode",
"purpose",
"attestor",
"createdAt"
],
"additionalProperties": false,
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.attestation_open"
},
"attestationId": {
"$ref": "#/$defs/AttestationId"
},
"mode": {
"$ref": "#/$defs/Mode"
},
"purpose": {
"type": "string",
"maxLength": 1000
},
"attestor": {
"$ref": "#/$defs/ParticipantKeyRef"
},
"createdAt": {
"$ref": "#/$defs/Timestamp"
}
}
},
"CloseReason": {
"type": "string",
"enum": [
"agent_closed",
"idle_timeout",
"agent_suspended",
"message_limit",
"owner_declined_pause"
]
},
"CloseStatement": {
"type": "object",
"required": [
"v",
"type",
"sessionId",
"headSeq",
"headHash",
"closedAt"
],
"additionalProperties": false,
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.close"
},
"sessionId": {
"$ref": "#/$defs/SessionId"
},
"headSeq": {
"type": "integer",
"minimum": 0
},
"headHash": {
"$ref": "#/$defs/NullableHash"
},
"closedAt": {
"$ref": "#/$defs/Timestamp"
}
}
},
"Evidence": {
"type": "object",
"description": "offer/accept (session) and open (attestation) are mutually exclusive — exactly one pair is populated, matching the record's kind.",
"required": [
"v",
"type",
"offer",
"offerSignature",
"accept",
"acceptSignature",
"open",
"openSignature",
"genesisHash",
"genesisSignature",
"messages",
"close"
],
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.evidence"
},
"offer": {
"oneOf": [
{
"$ref": "#/$defs/Offer"
},
{
"type": "null"
}
]
},
"offerSignature": {
"oneOf": [
{
"$ref": "#/$defs/Signature"
},
{
"type": "null"
}
]
},
"accept": {
"oneOf": [
{
"$ref": "#/$defs/Accept"
},
{
"type": "null"
}
]
},
"acceptSignature": {
"oneOf": [
{
"$ref": "#/$defs/Signature"
},
{
"type": "null"
}
]
},
"open": {
"oneOf": [
{
"$ref": "#/$defs/AttestationOpen"
},
{
"type": "null"
}
]
},
"openSignature": {
"oneOf": [
{
"$ref": "#/$defs/Signature"
},
{
"type": "null"
}
]
},
"genesisHash": {
"$ref": "#/$defs/Hash"
},
"genesisSignature": {
"$ref": "#/$defs/Signature"
},
"messages": {
"type": "array",
"items": {
"$ref": "#/$defs/EvidenceMessage"
}
},
"close": {
"oneOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"statement",
"signature"
],
"properties": {
"statement": {
"$ref": "#/$defs/CloseStatement"
},
"signature": {
"$ref": "#/$defs/Signature"
}
}
}
]
}
}
},
"EvidenceMessage": {
"type": "object",
"required": [
"envelope",
"hash",
"signature",
"receivedAt",
"platformSignature"
],
"properties": {
"envelope": {
"$ref": "#/$defs/MessageEnvelope"
},
"hash": {
"$ref": "#/$defs/Hash"
},
"signature": {
"$ref": "#/$defs/Signature"
},
"receivedAt": {
"$ref": "#/$defs/Timestamp"
},
"platformSignature": {
"$ref": "#/$defs/Signature"
},
"payload": {},
"contentState": {
"description": "Realignment R1 (docs/SPEC.md §13.1). Absent means \"plain\". \"encrypted\" means payload is an EncryptedPayload blob, not the agent's original content — see Bundle's decryptedPayloads for the authorized-viewer plaintext.",
"type": "string",
"enum": [
"plain",
"encrypted"
]
}
}
},
"Hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"Kid": {
"type": "string",
"pattern": "^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32}|new)$"
},
"MessageEnvelope": {
"type": "object",
"description": "hash = H(bytes(prevHash) || utf8(JCS(envelope))); signed with purpose \"message\".",
"required": [
"v",
"type",
"sessionId",
"seq",
"prevHash",
"sender",
"contentType",
"payloadHash",
"sentAt"
],
"additionalProperties": false,
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.message"
},
"sessionId": {
"$ref": "#/$defs/SessionId"
},
"seq": {
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"prevHash": {
"$ref": "#/$defs/Hash"
},
"sender": {
"type": "object",
"required": [
"agentId",
"kid"
],
"additionalProperties": false,
"properties": {
"agentId": {
"$ref": "#/$defs/AgentId"
},
"kid": {
"$ref": "#/$defs/Kid"
}
}
},
"contentType": {
"type": "string",
"maxLength": 100
},
"payloadHash": {
"$ref": "#/$defs/Hash"
},
"sentAt": {
"$ref": "#/$defs/Timestamp"
}
}
},
"Mode": {
"type": "string",
"enum": [
"relay",
"notary"
]
},
"NullableHash": {
"oneOf": [
{
"$ref": "#/$defs/Hash"
},
{
"type": "null"
}
]
},
"Offer": {
"type": "object",
"description": "Signed by the initiator with purpose \"offer\" over H(JCS(offer)).",
"required": [
"v",
"type",
"sessionId",
"mode",
"purpose",
"initiator",
"counterparty",
"idleTimeoutSec",
"createdAt",
"expiresAt"
],
"additionalProperties": false,
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.offer"
},
"sessionId": {
"$ref": "#/$defs/SessionId"
},
"mode": {
"$ref": "#/$defs/Mode"
},
"purpose": {
"type": "string",
"maxLength": 1000
},
"initiator": {
"$ref": "#/$defs/ParticipantKeyRef"
},
"counterparty": {
"oneOf": [
{
"type": "object",
"required": [
"agentId"
],
"additionalProperties": false,
"properties": {
"agentId": {
"$ref": "#/$defs/AgentId"
}
}
},
{
"type": "null"
}
]
},
"idleTimeoutSec": {
"type": "integer",
"minimum": 60,
"maximum": 604800
},
"createdAt": {
"$ref": "#/$defs/Timestamp"
},
"expiresAt": {
"$ref": "#/$defs/Timestamp"
}
}
},
"OwnerId": {
"type": "string",
"pattern": "^own_[0-9A-HJKMNP-TV-Z]{26}$"
},
"ParticipantKeyRef": {
"type": "object",
"required": [
"agentId",
"kid",
"publicKey"
],
"additionalProperties": false,
"properties": {
"agentId": {
"$ref": "#/$defs/AgentId"
},
"kid": {
"$ref": "#/$defs/Kid"
},
"publicKey": {
"$ref": "#/$defs/PublicKey"
}
}
},
"PlatformKey": {
"type": "object",
"required": [
"kid",
"alg",
"publicKey",
"validFrom",
"validUntil"
],
"properties": {
"kid": {
"type": "string"
},
"alg": {
"type": "string",
"enum": [
"Ed25519",
"ECDSA_P256_SHA256"
]
},
"publicKey": {
"type": "string",
"description": "ECDSA P-256: SPKI DER, base64url (SPEC D6)."
},
"validFrom": {
"$ref": "#/$defs/Timestamp"
},
"validUntil": {
"oneOf": [
{
"$ref": "#/$defs/Timestamp"
},
{
"type": "null"
}
]
}
}
},
"PublicKey": {
"type": "string",
"description": "Raw 32-byte Ed25519 public key, base64url without padding.",
"pattern": "^[A-Za-z0-9_-]{43}$"
},
"RecordStatement": {
"type": "object",
"description": "Signed by the platform with purpose \"record\" over H(JCS(statement)).",
"required": [
"v",
"type",
"recordId",
"sessionId",
"mode",
"purpose",
"participants",
"genesisHash",
"headSeq",
"headHash",
"messageCount",
"activatedAt",
"closedAt",
"closeReason",
"closedBy",
"evidenceSha256",
"issuedAt"
],
"additionalProperties": false,
"properties": {
"v": {
"type": "integer",
"const": 1
},
"type": {
"type": "string",
"const": "openglass.record"
},
"kind": {
"type": "string",
"enum": [
"session",
"attestation"
],
"description": "Absent means \"session\" — every record issued before this field existed. Never retroactively added to an already-signed, already-hashed statement."
},
"recordId": {
"type": "string"
},
"sessionId": {
"description": "Holds the attestation id when kind is \"attestation\" — same field, reused.",
"oneOf": [
{
"$ref": "#/$defs/SessionId"
},
{
"$ref": "#/$defs/AttestationId"
}
]
},
"mode": {
"$ref": "#/$defs/Mode"
},
"purpose": {
"type": "string"
},
"participants": {
"type": "array",
"minItems": 1,
"maxItems": 2,
"description": "1 entry (role \"attestor\") for an attestation, 2 (initiator/counterparty) for a session.",
"items": {
"type": "object",
"required": [
"role",
"agentId",
"ownerId",
"kid",
"publicKey"
],
"properties": {
"role": {
"type": "string",
"enum": [
"initiator",
"counterparty",
"attestor"
]
},
"agentId": {
"$ref": "#/$defs/AgentId"
},
"ownerId": {
"$ref": "#/$defs/OwnerId"
},
"kid": {
"$ref": "#/$defs/Kid"
},
"publicKey": {
"$ref": "#/$defs/PublicKey"
}
}
}
},
"genesisHash": {
"$ref": "#/$defs/Hash"
},
"headSeq": {
"type": "integer",
"minimum": 0
},
"headHash": {
"$ref": "#/$defs/NullableHash"
},
"messageCount": {
"type": "integer",
"minimum": 0
},
"activatedAt": {
"$ref": "#/$defs/Timestamp"
},
"closedAt": {
"$ref": "#/$defs/Timestamp"
},
"closeReason": {
"$ref": "#/$defs/CloseReason"
},
"closedBy": {
"oneOf": [
{
"$ref": "#/$defs/AgentId"
},
{
"type": "null"
}
]
},
"evidenceSha256": {
"$ref": "#/$defs/Hash"
},
"issuedAt": {
"$ref": "#/$defs/Timestamp"
},
"visibility": {
"description": "Realignment R1 (docs/SPEC.md §13). Absent means \"shared\" — every record issued before this field existed.",
"oneOf": [
{
"$ref": "#/$defs/Visibility"
},
{
"type": "null"
}
]
},
"retention": {
"description": "Present only when visibility is \"private\". Platform-signed at issuance so a record's own declared expiry is tamper-evident.",
"oneOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"days",
"expiresAt"
],
"properties": {
"days": {
"type": "integer",
"minimum": 1,
"maximum": 3650
},
"expiresAt": {
"$ref": "#/$defs/Timestamp"
}
}
}
]
}
}
},
"SessionId": {
"type": "string",
"pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$"
},
"Signature": {
"type": "object",
"required": [
"alg",
"kid",
"sig"
],
"additionalProperties": false,
"properties": {
"alg": {
"type": "string",
"enum": [
"Ed25519",
"ECDSA_P256_SHA256"
]
},
"kid": {
"$ref": "#/$defs/Kid"
},
"sig": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$"
}
}
},
"Timestamp": {
"type": "string",
"format": "date-time",
"description": "RFC 3339 UTC with milliseconds, e.g. 2026-09-22T22:07:00.000Z",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
},
"Visibility": {
"type": "string",
"description": "Realignment R1 (docs/SPEC.md §13). A sibling request-body field, not part of the signed offer/open object. Sessions default to \"shared\"; attestations default to \"private\". \"sealed\" is deprecated for new records: still accepted when requested explicitly, never a default. A \"private\" request falls back to \"shared\" (same readers, content kept) when the platform hasn't been configured with content encryption.",
"enum": [
"private",
"sealed",
"shared"
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/openglass-glass-bundle"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.