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

# Replace QR group properties

> Replaces the group's full property set. Properties not in the request body are removed; an empty `properties` array clears them all. Keys must be unique within the request.



## OpenAPI

````yaml /openapi.json put /qr-groups/{id}/properties
openapi: 3.1.0
info:
  title: Awardee API
  version: 1.0.0
  description: >-
    Public REST API for managing Awardee resources. All requests authenticate
    with an API key. Keys are scoped to a single organization.
servers:
  - url: https://api.awardee.com/v1
    description: Production
security:
  - api_key: []
paths:
  /qr-groups/{id}/properties:
    put:
      tags:
        - QR Groups
      summary: Replace QR group properties
      description: >-
        Replaces the group's full property set. Properties not in the request
        body are removed; an empty `properties` array clears them all. Keys must
        be unique within the request.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                properties:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      key:
                        type: string
                        minLength: 1
                      value:
                        type: string
                    required:
                      - key
                      - value
                    additionalProperties: false
              required:
                - properties
      responses:
        '200':
          description: Properties after replace
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    const: list
                  total:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  page:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  page_size:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        key:
                          type: string
                        value:
                          type: string
                        sort_order:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        created_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                        updated_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                      required:
                        - id
                        - key
                        - value
                        - sort_order
                        - created_at
                        - updated_at
                      additionalProperties: false
                required:
                  - object
                  - total
                  - page
                  - page_size
                  - data
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Machine-readable error code.
                  message:
                    type: string
                  request_id:
                    type: string
                  details: {}
                  retry_after:
                    type: number
                required:
                  - error
                  - message
                additionalProperties: false
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Machine-readable error code.
                  message:
                    type: string
                  request_id:
                    type: string
                  details: {}
                  retry_after:
                    type: number
                required:
                  - error
                  - message
                additionalProperties: false
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Machine-readable error code.
                  message:
                    type: string
                  request_id:
                    type: string
                  details: {}
                  retry_after:
                    type: number
                required:
                  - error
                  - message
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Machine-readable error code.
                  message:
                    type: string
                  request_id:
                    type: string
                  details: {}
                  retry_after:
                    type: number
                required:
                  - error
                  - message
                additionalProperties: false
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Machine-readable error code.
                  message:
                    type: string
                  request_id:
                    type: string
                  details: {}
                  retry_after:
                    type: number
                required:
                  - error
                  - message
                additionalProperties: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Machine-readable error code.
                  message:
                    type: string
                  request_id:
                    type: string
                  details: {}
                  retry_after:
                    type: number
                required:
                  - error
                  - message
                additionalProperties: false
components:
  securitySchemes:
    api_key:
      type: http
      scheme: bearer
      bearerFormat: aw_live_<hex>
      description: >-
        Send your API key as `Authorization: Bearer aw_live_…`. Manage keys in
        the dashboard under Settings → API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.