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

# Update multiple points boosts

> Update multiple points boosts.



## OpenAPI

````yaml https://admin.trophy.so/v1/openapi patch /points/{systemId}/boosts
openapi: 3.1.0
info:
  title: Trophy
  version: 1.19.0
servers:
  - x-fern-server-name: Admin API
    url: https://admin.trophy.so/v1
    description: Admin API
security: []
paths:
  /points/{systemId}/boosts:
    servers:
      - url: https://admin.trophy.so/v1
        description: Admin API
    parameters:
      - $ref: '#/components/parameters/TenantId'
    patch:
      tags:
        - Admin
      summary: Update multiple points boosts
      description: Update multiple points boosts.
      operationId: admin_points_boosts_update
      parameters:
        - name: systemId
          in: path
          description: The UUID of the points system.
          required: true
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
      requestBody:
        description: Array of boost patches.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchPointsBoostsRequest'
            examples:
              Update boost names and multipliers:
                value:
                  - id: 550e8400-e29b-41d4-a716-446655440000
                    name: Updated Boost Name
                    multiplier: 3
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchPointsBoostsResponse'
              examples:
                Success:
                  value:
                    updated:
                      - id: 550e8400-e29b-41d4-a716-446655440000
                        name: Updated Boost Name
                        status: active
                        start: '2024-01-01'
                        end: '2024-01-03'
                        multiplier: 3
                        rounding: down
                        userId: user-123
                    issues: []
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminErrorBody'
        '404':
          description: Not Found (points system not found)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminErrorBody'
        '422':
          description: Unprocessible Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminErrorBody'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: javascript
          source: >
            import { TrophyApiClient } from '@trophyso/node';


            const trophy = new TrophyApiClient({
              apiKey: 'YOUR_API_KEY'
            });


            const response = await
            trophy.admin.points.boosts.update('system-uuid', [
              {
                id: 'boost-uuid-1',
                name: 'Updated Boost Name',
                multiplier: 3
              }
            ]);
        - lang: python
          source: |
            from trophy import TrophyApi

            client = TrophyApi(api_key='YOUR_API_KEY')

            response = client.admin.points.boosts.update(
              system_id='system-uuid',
              boosts=[
                {
                  "id": "boost-uuid-1",
                  "name": "Updated Boost Name",
                  "multiplier": 3
                }
              ]
            )
        - lang: go
          source: >
            import (
              "context"

              api "github.com/trophyso/trophy-go"
              trophyclient "github.com/trophyso/trophy-go/client"
              "github.com/trophyso/trophy-go/option"
            )


            client := trophyclient.NewClient(
              option.WithApiKey("YOUR_API_KEY"),
            )


            response, err := client.Admin.Points.Boosts.Update(context.TODO(),
            "system-uuid", api.PatchPointsBoostsRequest{})
components:
  parameters:
    TenantId:
      name: Tenant-ID
      in: header
      description: >-
        The tenant identifier for multi-tenant organisations. Required when the
        organisation has multi-tenancy enabled. Pass your own internal customer
        ID for the tenant. Ignored for single-tenant organisations.
      required: false
      schema:
        type: string
      example: customer_12345
  schemas:
    PatchPointsBoostsRequest:
      title: PatchPointsBoostsRequest
      type: array
      description: Array of points boost patches. Maximum 100 per request.
      items:
        type: object
        properties:
          id:
            type: string
            format: uuid
            description: The UUID of the boost to update.
          name:
            type: string
            description: Updated name for the boost.
            maxLength: 255
          start:
            type: string
            format: date
            description: Updated start date (YYYY-MM-DD).
          end:
            type:
              - string
              - 'null'
            format: date
            description: Updated end date (YYYY-MM-DD) or null to remove end date.
          multiplier:
            type: number
            description: Updated points multiplier.
            exclusiveMinimum: 0
            exclusiveMaximum: 100
          rounding:
            type: string
            enum:
              - down
              - up
              - nearest
            description: Updated rounding strategy.
          userAttributes:
            type:
              - array
              - 'null'
            description: >-
              Updated user attribute filters. Cannot be set on user-specific
              boosts. Set to null to clear.
            items:
              type: object
              properties:
                attributeId:
                  type: string
                  format: uuid
                  description: The UUID of the user attribute.
                attributeValue:
                  type: string
                  description: The value to match.
              required:
                - attributeId
                - attributeValue
        required:
          - id
      maxItems: 100
      minItems: 1
    PatchPointsBoostsResponse:
      title: PatchPointsBoostsResponse
      type: object
      description: Response containing updated boosts and any issues encountered.
      properties:
        updated:
          type: array
          items:
            $ref: '#/components/schemas/AdminPointsBoost'
          description: Array of successfully updated boosts.
        issues:
          type: array
          items:
            $ref: '#/components/schemas/AdminIssue'
          description: Array of issues encountered during boost updates.
      required:
        - updated
        - issues
    AdminErrorBody:
      title: AdminErrorBody
      type: object
      properties:
        error:
          type: string
      required:
        - error
    AdminPointsBoost:
      title: AdminPointsBoost
      type: object
      description: A points boost as returned from admin endpoints.
      properties:
        id:
          type: string
          format: uuid
          description: The UUID of the boost.
        name:
          type: string
          description: The name of the boost.
        status:
          type: string
          enum:
            - active
            - scheduled
            - finished
          description: The status of the boost.
        start:
          type: string
          format: date
          description: The start date (YYYY-MM-DD).
        end:
          type:
            - string
            - 'null'
          format: date
          description: The end date (YYYY-MM-DD) or null if no end date.
        multiplier:
          type: number
          description: The points multiplier.
        rounding:
          type: string
          enum:
            - down
            - up
            - nearest
          description: How boosted points are rounded.
        userId:
          type:
            - string
            - 'null'
          description: >-
            The ID of the user the boost was created for, or null for
            global/attribute-filtered boosts.
        userAttributes:
          type: array
          description: >-
            User attribute filters applied to the boost. Only present for
            non-user-specific boosts (i.e. when `userId` is null). Empty array
            if no filters are set.
          items:
            type: object
            properties:
              attributeId:
                type: string
                format: uuid
                description: The UUID of the user attribute.
              attributeValue:
                type: string
                description: The matched attribute value.
            required:
              - attributeId
              - attributeValue
      required:
        - id
        - name
        - status
        - start
        - end
        - multiplier
        - rounding
        - userId
    AdminIssue:
      title: AdminIssue
      type: object
      description: An issue encountered while processing an item in an admin API request.
      properties:
        id:
          type: string
          description: The ID of the resource the issue relates to, when applicable.
          example: 550e8400-e29b-41d4-a716-446655440000
        userId:
          type: string
          description: The ID of the user the issue relates to, when applicable.
          example: user-123
        boostId:
          type: string
          description: The ID of the points boost the issue relates to, when applicable.
          example: 550e8400-e29b-41d4-a716-446655440000
        index:
          type: integer
          description: >-
            The zero-based index of the item the issue relates to, when no
            resource ID exists yet.
          example: 0
        severity:
          type: string
          enum:
            - error
            - warning
          description: The severity level of the issue.
          example: warning
        message:
          type: string
          description: A human-readable description of the issue.
          example: Would exceed maximum freeze limit
      required:
        - severity
        - message
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````