> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Replace an operator fixed-width layout template > Fully replaces a stored per-tenant fixed-width layout template (records/fields/discriminator/recordWidths/requiredFields) by its id — a PUT full replace, not a sparse patch, since the byte-range invariants are whole-layout properties. The replacement is run through the SAME well-formedness gate the submission path enforces BEFORE storage: overrun, overlap, missing-required, zero-field, or a mis-marked money column (money MUST be kind=decimal) rejects with 422 and the stored template is left unchanged. Returns 404 when no active template matches, 409 when the new format key collides with another active template. Tenant from the JWT; never the body. ## OpenAPI ````yaml en/openapi/v3-current/matcher.yaml put /v1/imports/formats/templates/{templateId} openapi: 3.1.0 info: title: Matcher APIs description: >- Complete API reference for the Matcher reconciliation engine, providing automated transaction matching between Midaz Ledger and external systems. version: 4.1.0 license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license servers: - url: https://matcher.sandbox.lerian.net security: [] paths: /v1/imports/formats/templates/{templateId}: put: tags: - Ingestion summary: Replace an operator fixed-width layout template description: >- Fully replaces a stored per-tenant fixed-width layout template (records/fields/discriminator/recordWidths/requiredFields) by its id — a PUT full replace, not a sparse patch, since the byte-range invariants are whole-layout properties. The replacement is run through the SAME well-formedness gate the submission path enforces BEFORE storage: overrun, overlap, missing-required, zero-field, or a mis-marked money column (money MUST be kind=decimal) rejects with 422 and the stored template is left unchanged. Returns 404 when no active template matches, 409 when the new format key collides with another active template. Tenant from the JWT; never the body. operationId: updateLayoutTemplate parameters: - description: Layout template ID in: path name: templateId required: true schema: description: Layout template ID format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateLayoutTemplateRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/LayoutTemplateResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: CreateLayoutTemplateRequest: additionalProperties: false properties: discriminatorLength: description: Discriminator width in bytes examples: - 1 format: int64 minimum: 1 type: integer discriminatorStart: description: Zero-based byte offset of the record-type discriminator examples: - 0 format: int64 minimum: 0 type: integer family: description: Format family the template namespaces under examples: - cnab400 minLength: 1 type: string records: description: Record types declared by the layout items: $ref: '#/components/schemas/LayoutTemplateRecordRequest' minItems: 1 type: - array - 'null' region: description: ISO alpha-2 region (uppercased) or XX examples: - BR minLength: 1 type: string requiredFields: description: Field names the variant must declare items: type: string type: - array - 'null' variant: description: Operator/brand variant axis examples: - acme-cobranca minLength: 1 type: string required: - region - family - variant - discriminatorStart - discriminatorLength - records type: object LayoutTemplateResponse: additionalProperties: false properties: createdAt: description: Creation timestamp (RFC 3339, UTC) examples: - '2025-01-15T10:30:00Z' format: date-time type: string discriminator: $ref: '#/components/schemas/LayoutTemplateDiscriminatorResponse' description: >- Record-type discriminator byte range the parser reads to select a record type formatKey: description: >- Canonical format descriptor key (region/family/variant) the template registers under examples: - br/cnab400/acme-cobranca type: string id: description: Template identifier examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string recordTypeCount: description: Number of record types the layout declares examples: - 1 format: int64 type: integer recordWidths: additionalProperties: format: int64 type: integer description: Per-record-type fixed width in bytes, keyed by record type type: object records: description: >- Record types the layout declares, each with its fixed width and ordered byte-range fields, sorted by record type items: $ref: '#/components/schemas/LayoutTemplateRecordResponse' type: - array - 'null' requiredFields: description: Field names the variant must declare across its record types items: type: string type: - array - 'null' variantKey: description: In-file variant key the layout is keyed by examples: - acme-cobranca type: string required: - id - formatKey - variantKey - recordTypeCount - discriminator - records - recordWidths - requiredFields - createdAt type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object LayoutTemplateRecordRequest: additionalProperties: false properties: fields: description: Ordered positional fields of this record type items: $ref: '#/components/schemas/LayoutTemplateFieldRequest' type: - array - 'null' recordType: description: Record-type value the discriminator byte slice must match (e.g. "1") examples: - '1' type: string width: description: Fixed width in bytes every record of this type must be examples: - 33 format: int64 type: integer required: - recordType - width - fields type: object LayoutTemplateDiscriminatorResponse: additionalProperties: false properties: length: description: Discriminator width in bytes examples: - 1 format: int64 type: integer startByte: description: Zero-based byte offset of the record-type discriminator examples: - 0 format: int64 type: integer required: - startByte - length type: object LayoutTemplateRecordResponse: additionalProperties: false properties: fields: description: Ordered positional fields of this record type items: $ref: '#/components/schemas/LayoutTemplateFieldResponse' type: - array - 'null' recordType: description: Record-type value the discriminator byte slice matches (e.g. "1") examples: - '1' type: string width: description: Fixed width in bytes every record of this type must be examples: - 33 format: int64 type: integer required: - recordType - width - fields type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object LayoutTemplateFieldRequest: additionalProperties: false properties: kind: description: >- Value type: string (raw text), decimal (money/numeric verbatim token, parsed downstream), or date. A money column MUST be decimal examples: - decimal type: string length: description: Field width in bytes (must be greater than 0) examples: - 12 format: int64 type: integer name: description: >- Canonical field name this byte slice feeds (e.g. external_id, amount, currency, date) examples: - amount type: string startByte: description: Zero-based byte offset where the field begins examples: - 11 format: int64 type: integer required: - name - startByte - length - kind type: object LayoutTemplateFieldResponse: additionalProperties: false properties: kind: description: >- Value type: string (raw text), decimal (money/numeric verbatim token, parsed downstream), or date examples: - decimal type: string length: description: Field width in bytes examples: - 12 format: int64 type: integer name: description: >- Canonical field name this byte slice feeds (e.g. external_id, amount, currency, date) examples: - amount type: string startByte: description: Zero-based byte offset where the field begins examples: - 11 format: int64 type: integer required: - name - startByte - length - kind type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Bearer token authentication (format: "Bearer {token}")' ````