schemas_get

Fetch a specific data shape by identifier and version.

Key notes

• Requires tenant_id, namespace_id, schema_id, and version.
• Fails closed when schema is missing.

Inputs

• namespace_id (required): Namespace identifier.
• schema_id (required): Data shape identifier.
• tenant_id (required): Tenant identifier.
• version (required): Data shape version identifier.

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "namespace_id": {
      "description": "Namespace identifier.",
      "minimum": 1,
      "type": "integer"
    },
    "schema_id": {
      "description": "Data shape identifier.",
      "type": "string"
    },
    "tenant_id": {
      "description": "Tenant identifier.",
      "minimum": 1,
      "type": "integer"
    },
    "version": {
      "description": "Data shape version identifier.",
      "type": "string"
    }
  },
  "required": [
    "tenant_id",
    "namespace_id",
    "schema_id",
    "version"
  ],
  "type": "object"
}

Outputs

• record (required): Type: object.

Output Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "record": {
      "additionalProperties": false,
      "properties": {
        "created_at": {
          "oneOf": [
            {
              "additionalProperties": false,
              "properties": {
                "kind": {
                  "const": "unix_millis"
                },
                "value": {
                  "type": "integer"
                }
              },
              "required": [
                "kind",
                "value"
              ],
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "kind": {
                  "const": "logical"
                },
                "value": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "kind",
                "value"
              ],
              "type": "object"
            }
          ]
        },
        "description": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "description": "Optional schema description.",
              "type": "string"
            }
          ]
        },
        "namespace_id": {
          "description": "Namespace identifier.",
          "minimum": 1,
          "type": "integer"
        },
        "schema": {
          "description": "JSON Schema payload.",
          "type": [
            "null",
            "boolean",
            "number",
            "string",
            "array",
            "object"
          ]
        },
        "schema_id": {
          "description": "Data shape identifier.",
          "type": "string"
        },
        "signing": {
          "additionalProperties": false,
          "properties": {
            "algorithm": {
              "default": null,
              "oneOf": [
                {
                  "type": "null"
                },
                {
                  "description": "Signature algorithm label.",
                  "type": "string"
                }
              ]
            },
            "key_id": {
              "description": "Signing key identifier.",
              "type": "string"
            },
            "signature": {
              "description": "Schema signature string.",
              "type": "string"
            }
          },
          "required": [
            "key_id",
            "signature"
          ],
          "type": "object"
        },
        "tenant_id": {
          "description": "Tenant identifier.",
          "minimum": 1,
          "type": "integer"
        },
        "version": {
          "description": "Data shape version identifier.",
          "type": "string"
        }
      },
      "required": [
        "tenant_id",
        "namespace_id",
        "schema_id",
        "version",
        "schema",
        "description",
        "created_at"
      ],
      "type": "object"
    }
  },
  "required": [
    "record"
  ],
  "type": "object"
}

Examples

Fetch a data shape by identifier and version.

Input:

{
  "namespace_id": 1,
  "schema_id": "asserted_payload",
  "tenant_id": 1,
  "version": "v1"
}

Output:

{
  "record": {
    "created_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "description": "Asserted payload schema.",
    "namespace_id": 1,
    "schema": {
      "additionalProperties": false,
      "properties": {
        "deploy_env": {
          "type": "string"
        }
      },
      "required": [
        "deploy_env"
      ],
      "type": "object"
    },
    "schema_id": "asserted_payload",
    "tenant_id": 1,
    "version": "v1"
  }
}