> ## 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 points systems > Update points systems by ID. ## OpenAPI ````yaml https://admin.trophy.so/v1/openapi patch /points 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: servers: - url: https://admin.trophy.so/v1 description: Admin API parameters: - $ref: '#/components/parameters/TenantId' patch: tags: - Admin summary: Update points systems description: Update points systems by ID. operationId: admin_points_systems_update requestBody: description: Array of points system updates. Maximum 100 systems per request. required: true content: application/json: schema: $ref: '#/components/schemas/UpdatePointsSystemsRequest' examples: Update a system name: value: - id: 550e8400-e29b-41d4-a716-446655440000 name: New Name responses: '200': description: Successful operation content: application/json: schema: $ref: '#/components/schemas/UpdatePointsSystemsResponse' examples: Success: value: updated: - id: 550e8400-e29b-41d4-a716-446655440000 name: New Name key: xp description: '' status: active badge: null maxPoints: null issues: [] '401': description: Unauthorized 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 result = await trophy.admin.points.systems.update([ { id: 'system-uuid', name: 'New Name', description: 'Updated description' } ]); - lang: python source: | from trophy import TrophyApi client = TrophyApi(api_key='YOUR_API_KEY') result = client.admin.points.systems.update( request=[{ "id": "system-uuid", "name": "New Name", "description": "Updated description" }] ) - 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.Systems.Update(context.TODO(), api.UpdatePointsSystemsRequest{}) 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: UpdatePointsSystemsRequest: title: UpdatePointsSystemsRequest type: array description: Request body for updating points systems. items: $ref: '#/components/schemas/UpdatePointsSystemRequestItem' minItems: 1 maxItems: 100 UpdatePointsSystemsResponse: title: UpdatePointsSystemsResponse type: object description: Response containing updated points systems and any per-item issues. properties: updated: type: array items: $ref: '#/components/schemas/AdminPointsSystem' description: Array of successfully updated points systems. issues: type: array items: $ref: '#/components/schemas/AdminIssue' description: Array of issues encountered during update. required: - updated - issues AdminErrorBody: title: AdminErrorBody type: object properties: error: type: string required: - error UpdatePointsSystemRequestItem: title: UpdatePointsSystemRequestItem type: object description: >- A points system update object. Only id is required; all other fields are optional. properties: id: type: string format: uuid description: The UUID of the points system to update. example: 550e8400-e29b-41d4-a716-446655440000 name: type: string description: Updated name. description: type: string description: Updated description. badge: oneOf: - type: object properties: url: type: string required: - url - type: 'null' description: Updated badge. Set to null to remove. maxPoints: type: - integer - 'null' minimum: 1 description: Updated max points. Set to null to remove. required: - id AdminPointsSystem: title: AdminPointsSystem type: object description: A points system returned from the admin points systems endpoints. properties: id: type: string format: uuid description: The UUID of the points system. name: type: string description: The points system name. key: type: string description: The points system key. description: type: string description: The points system description. status: type: string enum: - active - archived description: The points system status. badge: oneOf: - type: object properties: url: type: string required: - url - type: 'null' description: The badge for the points system. maxPoints: type: - integer - 'null' description: The maximum points a user can earn. required: - id - name - key - description - status - badge - maxPoints 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 ````