OpenGlass · Schema

Bundle

Artificial IntelligenceData IntegritySecurityAgent PlatformTransparency

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).
View JSON Schema on GitHub

JSON Schema

openglass-glass-bundle-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.