> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bm.cards/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a wallet template

> Updates template configuration for the program.



## OpenAPI

````yaml /openapi/brand-api.json patch /{brand_id}/programs/{program_id}/templates
openapi: 3.0.0
info:
  title: Bambu Brand API
  description: >-
    Partner APIs for issuing and managing wallet cards, activations,
    transactions, SMS, and program configuration. Start with the Guides tab for
    authentication and your first issue-wallet call.
  version: 1.0.0
servers:
  - url: https://api.bambumeta.software/brands
    description: Production
  - url: https://api-sandbox.bambumeta.software/brands
    description: Sandbox
security: []
tags:
  - name: brand
    description: Brand setup and configuration
  - name: brand-activation
    description: Onboarding activations and issue-wallet for an activation
  - name: brands
    description: Custom brand attribute fields
  - name: link-activation
    description: Distribution link activation CRUD
  - name: onboarding
    description: >-
      Program onboarding metrics (internal tag, grouped under reporting in the
      portal)
  - name: program
    description: Program setup and transactions
  - name: reporting
    description: Pass and stage breakdown reports
  - name: sms
    description: Send outbound SMS messages
  - name: subscription
    description: SMS subscription enrollment and stage updates
  - name: template
    description: Wallet template management
  - name: transactions
    description: Transaction types, records, and program transactions
  - name: wallet
    description: Issue, retrieve, update, and delete wallet cards
  - name: wallet-bulk
    description: Bulk pass updates and scheduled changes
  - name: workflow
    description: Trigger workflows that issue or update passes
paths:
  /{brand_id}/programs/{program_id}/templates:
    patch:
      tags:
        - program
        - onboarding
        - template
      summary: Update a wallet template
      description: Updates template configuration for the program.
      parameters:
        - name: brand_id
          in: path
          description: Brand Identifier
          required: true
          style: simple
          explode: false
          schema:
            type: string
          example: '353'
        - name: program_id
          in: path
          description: Program Identifier
          required: true
          style: simple
          explode: false
          schema:
            type: string
          example: '1396'
      requestBody:
        description: Template record creation input
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TemplateInput'
            example:
              name: Membership card v2
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateCreated'
              example:
                templateId: 100
                name: Membership card v2
      security:
        - cognito-authorizer:
            - https://admin.bambumeta.software/ui
components:
  schemas:
    TemplateInput:
      type: object
      properties:
        name:
          type: string
        organizationName:
          type: string
        sharingProhibited:
          type: boolean
        sharingUrl:
          type: string
        passdata:
          type: object
          properties:
            passStyle:
              type: string
            groupingIdentifier:
              type: string
            barCodes:
              type: array
              items:
                type: object
                properties:
                  messageEncoding:
                    type: string
                  format:
                    type: string
                  message:
                    type: string
                  altText:
                    type: string
                required:
                  - messageEncoding
                  - format
                  - message
            images:
              type: array
              items:
                type: object
                properties:
                  image:
                    type: string
                  imageFile:
                    type: string
                required:
                  - image
            headerFields:
              $ref: '#/components/schemas/FieldsList'
            primaryFields:
              $ref: '#/components/schemas/FieldsList'
            secondaryFields:
              $ref: '#/components/schemas/FieldsList'
            auxiliaryFields:
              $ref: '#/components/schemas/FieldsList'
            backFields:
              $ref: '#/components/schemas/FieldsList'
            nfcField:
              type: object
              properties:
                message:
                  type: string
                encryptionKey:
                  type: string
                securityEnabled:
                  type: boolean
              required:
                - message
                - encryptionKey
            backgroundColor:
              type: string
            foregroundColor:
              type: string
            labelColor:
              type: string
            description:
              type: string
            relevantDate:
              type: string
            expirationDate:
              type: string
            subheader:
              type: string
            associatedIdentifiers:
              type: array
              items:
                type: number
            includeLogoText:
              type: boolean
          required:
            - passStyle
            - images
        androidPassData:
          type: object
          properties:
            title:
              type: string
            header:
              type: string
            subheader:
              type: string
            hexBackgroundColor:
              type: string
            rows:
              type: array
              items:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: string
            detailRows:
              type: array
              items:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: string
            images:
              type: array
              items:
                type: object
                properties:
                  image:
                    type: string
                  imageFile:
                    type: string
                required:
                  - image
            validTimeInterval:
              type: object
              properties:
                start:
                  type: object
                  properties:
                    date:
                      type: string
                  required:
                    - date
                end:
                  type: object
                  properties:
                    date:
                      type: string
                  required:
                    - date
              required:
                - start
            nfcField:
              type: object
              properties:
                message:
                  type: string
                encryptionKey:
                  type: string
                securityEnabled:
                  type: boolean
              required:
                - message
                - encryptionKey
            venue:
              type: object
              properties:
                name:
                  type: string
                address:
                  type: string
              required:
                - name
                - address
            dateTime:
              type: object
              properties:
                doorsOpen:
                  type: string
                start:
                  type: string
                end:
                  type: string
                doorsOpenLabel:
                  type: string
                customDoorsOpenLabel:
                  $ref: '#/components/schemas/AndroidLocalizedString'
            seatInfo:
              type: object
              properties:
                seat:
                  $ref: '#/components/schemas/AndroidLocalizedString'
                row:
                  $ref: '#/components/schemas/AndroidLocalizedString'
                section:
                  $ref: '#/components/schemas/AndroidLocalizedString'
                gate:
                  $ref: '#/components/schemas/AndroidLocalizedString'
          required:
            - header
            - hexBackgroundColor
            - rows
            - images
        fieldMappings:
          type: array
          items:
            type: object
            properties:
              key:
                type: string
              label:
                type: string
              defaultValue:
                type: string
              mappedValue:
                type: string
              dateStyle:
                type: string
              timeStyle:
                type: string
              textAlignment:
                type: string
              changeMessage:
                type: string
              currencyCode:
                type: string
              numberStyle:
                type: string
              isRelative:
                type: boolean
              ignoresTimeZone:
                type: boolean
              androidType:
                type: string
              isDefault:
                type: boolean
            required:
              - key
              - label
        walletIdentifierId:
          type: number
        defaultMessage:
          type: string
      required:
        - name
        - organizationName
        - androidPassData
        - walletIdentifierId
    TemplateCreated:
      type: object
      properties:
        templateId:
          type: string
        message:
          type: string
    FieldsList:
      type: array
      items:
        type: string
    AndroidLocalizedString:
      type: object
      properties:
        defaultValue:
          type: object
          properties:
            language:
              type: string
            value:
              type: string
          required:
            - language
            - value
      required:
        - defaultValue
  securitySchemes:
    cognito-authorizer:
      type: apiKey
      name: Authorization
      in: header

````