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

# Edit an input field

> Updates an existing input field. Only include fields you want to change — omitted fields remain unchanged. Set `visitorFacingTitle` to `null` to clear it.



## OpenAPI

````yaml /api-reference/openapi.json patch /input-fields/{inputFieldId}
openapi: 3.1.0
info:
  title: Qminder API
  version: '1.0'
  description: >-
    The Qminder API allows you to integrate queue management into your own
    applications.
servers:
  - url: https://api.qminder.com
security:
  - sec0: []
tags:
  - name: Locations
    description: Manage physical service locations
  - name: Lines
    description: Manage virtual queues within locations
  - name: Input Fields
    description: Manage custom data fields for locations
  - name: Tickets
    description: Manage visitor queue entries
  - name: Appointments
    description: Manage scheduled appointments
  - name: Users
    description: Manage user accounts and permissions
  - name: Webhooks
    description: Manage webhook subscriptions
paths:
  /input-fields/{inputFieldId}:
    patch:
      tags:
        - Input Fields
      summary: Edit an input field
      description: >-
        Updates an existing input field. Only include fields you want to change
        — omitted fields remain unchanged. Set `visitorFacingTitle` to `null` to
        clear it.
      operationId: edit-input-field
      parameters:
        - name: inputFieldId
          in: path
          description: UUID of the input field to update.
          required: true
          schema:
            type: string
            format: uuid
        - name: X-Qminder-API-Version
          in: header
          description: API version. Must be set to `2020-09-01`.
          required: true
          schema:
            type: string
            enum:
              - '2020-09-01'
            default: '2020-09-01'
      requestBody:
        description: >-
          Input field properties to update. All fields are optional — only
          include fields you want to change.
        content:
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
                  maxLength: 50
                  description: >-
                    Display title. Only for TEXT, SELECT, URL, DATE, and NUMERIC
                    types.
                visitorFacingTitle:
                  type: string
                  maxLength: 200
                  nullable: true
                  description: >-
                    Title shown to visitors. Set to `null` to clear. Only for
                    TEXT, SELECT, DATE, and NUMERIC types.
                isVisibleInWaitingDrawer:
                  type: boolean
                  description: Shown in the waiting drawer.
                isVisibleInServingDrawer:
                  type: boolean
                  description: Shown in the serving drawer.
                isMandatoryBeforeAdded:
                  type: boolean
                  description: Must be filled before ticket is added.
                isMandatoryBeforeServed:
                  type: boolean
                  description: Must be filled before ticket is served.
                isMandatoryInRemoteSignIn:
                  type: boolean
                  description: Must be filled in remote sign-in.
                showInRemoteSignIn:
                  type: boolean
                  description: >-
                    Show in remote sign-in. Always treated as false for URL
                    fields.
                visibleForLines:
                  type: array
                  description: Lines this field applies to. Empty array means all lines.
                  items:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: Line ID.
                multiSelect:
                  type: boolean
                  description: Allow multiple selections. Only for SELECT type.
                options:
                  type: array
                  description: >-
                    Select options. Only for SELECT type. Options are matched by
                    ID — existing options are updated, new IDs are added,
                    missing IDs are removed.
                  items:
                    type: object
                    required:
                      - id
                      - title
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: >-
                          Option UUID. Use an existing ID to update, or a new
                          UUID to add.
                      title:
                        type: string
                        description: Option display title.
                      color:
                        type: string
                        description: Option color.
                constraints:
                  type: object
                  description: Numeric constraints. Only for NUMERIC type.
                  properties:
                    min:
                      type: number
                      description: Minimum allowed value.
                    max:
                      type: number
                      description: Maximum allowed value.
                    scale:
                      type: integer
                      description: Number of decimal places.
                translations:
                  type: array
                  description: >-
                    Translations. Available for TEXT, SELECT, URL, DATE, and
                    NUMERIC types. Replaces all existing translations.
                  items:
                    type: object
                    required:
                      - languageCode
                    properties:
                      languageCode:
                        type: string
                        description: Language code (e.g. "fr", "es").
                      title:
                        type: string
                        description: Translated field title.
                      visitorFacingTitle:
                        type: string
                        description: Translated visitor-facing title.
            example:
              title: Visit reason
              isVisibleInWaitingDrawer: false
              isMandatoryBeforeServed: true
      responses:
        '200':
          description: Input field updated successfully
        '400':
          description: Invalid request
          content:
            application/json:
              examples:
                InvalidArguments:
                  summary: Type-specific field set on wrong type
                  value:
                    code: invalid_arguments
                    message: title is not applicable for this input field type
                DuplicateOptions:
                  summary: SELECT options have duplicate titles
                  value:
                    code: duplicate_items_in_request
                    message: Duplicate option titles
                BlankTitle:
                  summary: Title is blank
                  value:
                    code: parameter_invalid_blank
                    message: Title must not be blank
        '404':
          description: Input field not found
          content:
            application/json:
              example:
                code: resource_missing
                message: Input field not found
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: X-Qminder-REST-API-Key
      x-default: yourbusinessapikey

````