Sustema

ENTITY developer reference

PublicContractBinding

Candidate documentation for reading and synthetic examples. Account creation, live API access, SDKs, collections and MCP are not available here. A released service profile and matching integration instructions are required before use.

This is a documentation reading view of an unreleased candidate, not a downloadable replacement schema. Public wire names, types and constraints are retained except for the explicitly marked private-only subsets and route patterns. Private governance references are explained in public language. Use only a separately released, verified generation for clients. Read the explicit exclusions.

This is the public candidate schema reading view. Read it with the operation that uses it; a representable field does not establish enabled coverage or entitlement.

For this exact CapabilityProfile profile_id and revision, read from its immutable qualified release manifest. binding_sha256 is the same full generation binding used by MCP initialization/tools/list; public_* hashes identify the exact published canonical-content bytes. Never hash the response containing this value or substitute the generic template for a compiled profile. Bootstrap capabilities identifies the generation before work; clients fetch/verify that public download, pin profile_id/revision/binding, then validate its canonical wire without coercion. A different or unavailable retained generation must not be silently replaced. The existing static public contract release bundle includes binding.json and binding.json.bytes containing the complete same generation binding exposed by MCP. They are adjacent to openapi.json/dictionary.json/errors.json in the documented immutable release bundle. REST-only clients fetch this bundle from the configured public documentation download location, verify its binding without binding_sha256 against the capability binding_sha256, then compare all three public content hashes and exact profile/generation. Never hash binding.json including its own binding_sha256. The outer release manifest binds the readable and canonical file hashes; no API endpoint or private source body is added. Public release is blocked until the documented download location and readback are qualified.

Declared type: "object"

Declared fields

This list shows only properties declared directly in this schema. Required labels refer only to this schema’s own required array. Referenced, composed and conditional rules can add constraints; a field not listed as required here is not guaranteed to be optional.

generation

Listed in this schema’s required array.

Declared type
"string"
Reading definition for generation
{
  "type": "string",
  "minLength": 1,
  "maxLength": 120
}

binding_sha256

Listed in this schema’s required array.

Declared type
"string"
Reading definition for binding_sha256
{
  "type": "string",
  "pattern": "^[a-f0-9]{64}$",
  "x-profile-maxLength": "string_characters_max"
}

public_api_sha256

Listed in this schema’s required array.

Declared type
"string"
Reading definition for public_api_sha256
{
  "type": "string",
  "pattern": "^[a-f0-9]{64}$",
  "x-profile-maxLength": "string_characters_max"
}

public_dictionary_sha256

Listed in this schema’s required array.

Declared type
"string"
Reading definition for public_dictionary_sha256
{
  "type": "string",
  "pattern": "^[a-f0-9]{64}$",
  "x-profile-maxLength": "string_characters_max"
}

public_errors_sha256

Listed in this schema’s required array.

Declared type
"string"
Reading definition for public_errors_sha256
{
  "type": "string",
  "pattern": "^[a-f0-9]{64}$",
  "x-profile-maxLength": "string_characters_max"
}

Schema reading view

Read all retained constraints, including any allOf, oneOf, anyOf, conditional and additional-property constraints. The field list does not combine branches. Explicitly marked private-only omissions mean this view is not an executable substitute for the original schema or a released contract.

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "generation": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "binding_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "x-profile-maxLength": "string_characters_max"
    },
    "public_api_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "x-profile-maxLength": "string_characters_max"
    },
    "public_dictionary_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "x-profile-maxLength": "string_characters_max"
    },
    "public_errors_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "x-profile-maxLength": "string_characters_max"
    }
  },
  "required": [
    "generation",
    "binding_sha256",
    "public_api_sha256",
    "public_dictionary_sha256",
    "public_errors_sha256"
  ],
  "description": "For this exact CapabilityProfile profile_id and revision, read from its immutable qualified release manifest. binding_sha256 is the same full generation binding used by MCP initialization/tools/list; public_* hashes identify the exact published canonical-content bytes. Never hash the response containing this value or substitute the generic template for a compiled profile. Bootstrap capabilities identifies the generation before work; clients fetch/verify that public download, pin profile_id/revision/binding, then validate its canonical wire without coercion. A different or unavailable retained generation must not be silently replaced. The existing static public contract release bundle includes binding.json and binding.json.bytes containing the complete same generation binding exposed by MCP. They are adjacent to openapi.json/dictionary.json/errors.json in the documented immutable release bundle. REST-only clients fetch this bundle from the configured public documentation download location, verify its binding without binding_sha256 against the capability binding_sha256, then compare all three public content hashes and exact profile/generation. Never hash binding.json including its own binding_sha256. The outer release manifest binds the readable and canonical file hashes; no API endpoint or private source body is added. Public release is blocked until the documented download location and readback are qualified."
}

All API operations