> ## 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.

# Delete multiple points levels

> Delete multiple points levels by ID.



## OpenAPI

````yaml https://admin.trophy.so/v1/openapi delete /points/{systemId}/levels
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}/levels:
    servers:
      - url: https://admin.trophy.so/v1
        description: Admin API
    parameters:
      - $ref: '#/components/parameters/TenantId'
    delete:
      tags:
        - Admin
      summary: Delete multiple points levels
      description: Delete multiple points levels by ID.
      operationId: admin_points_levels_delete
      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
        - name: ids
          in: query
          description: Comma-separated list of level UUIDs to delete.
          required: true
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: form
          explode: true
          example: >-
            a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11,b1ffcd00-0d1c-4ef9-cc7e-7cc0ce491b22
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletePointsLevelsResponse'
              examples:
                Deleted successfully:
                  value:
                    deleted:
                      - id: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
                    issues: []
                Partial success:
                  value:
                    deleted:
                      - id: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
                    issues:
                      - id: b1ffcd00-0d1c-4ef9-cc7e-7cc0ce491b22
                        severity: error
                        message: Level not found by ID
        '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 (no IDs provided or too many IDs)
          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.levels.delete('system-uuid', {
              ids: ['550e8400-e29b-41d4-a716-446655440000']
            });
        - lang: python
          source: |
            from trophy import TrophyApi

            client = TrophyApi(api_key='YOUR_API_KEY')

            result = client.admin.points.levels.delete(
              system_id='system-uuid',
              ids=['550e8400-e29b-41d4-a716-446655440000']
            )
        - 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.Levels.Delete(context.TODO(),
            "system-uuid", nil)
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:
    DeletePointsLevelsResponse:
      title: DeletePointsLevelsResponse
      type: object
      description: >-
        Response containing the points levels that were deleted and any per-item
        issues.
      properties:
        deleted:
          type: array
          items:
            $ref: '#/components/schemas/DeletedResource'
          description: Array of deleted points levels represented by ID.
        issues:
          type: array
          items:
            $ref: '#/components/schemas/AdminIssue'
          description: Array of issues encountered during level deletion.
      required:
        - deleted
        - issues
    AdminErrorBody:
      title: AdminErrorBody
      type: object
      properties:
        error:
          type: string
      required:
        - error
    DeletedResource:
      title: DeletedResource
      type: object
      description: A deleted resource represented by ID.
      properties:
        id:
          type: string
          format: uuid
          description: The ID of the deleted resource.
      required:
        - id
    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

````