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

# Update a ticket tier



## OpenAPI

````yaml /partner-docs/openapi.json patch /partners/events/{eventId}/ticket-tiers/{tierKey}
openapi: 3.0.0
info:
  title: Tickify Partner API
  description: >2-

        API documentation for the Tickify Partner Platform.

        Getting Started:
    1. Register as a partner and wait for approval from the Tickify team.
        2. Once approved, request an API key from the Tickify team. A Tickify admin will generate and securely share your API key with you.
        3. Use your API key to authenticate partner API requests.
        4. Generate an access token using the /partner/auth/token endpoint in the Auth documentation.
        5. Use the access token for authenticated requests where required.

        **API Keys:**
    - Test keys use the 

    `tk_test_` prefix. These keys work in sandbox mode and never charge real
    payment methods.

    - Live keys use the 

    `tk_live_` prefix. These keys process real payments and require completed
    Stripe Connect onboarding.

    - Both key types follow the same API behavior — only the payment environment
    differs.

    - To test checkout flows without real charges, use 

    `tk_test_` keys and include test card numbers in your Stripe integration.
        
  version: '1.0'
  contact: {}
servers:
  - url: http://localhost:3000
    description: Local Development
  - url: https://api-staging.tickify.io
    description: Staging
  - url: https://api.tickify.io
    description: Production
security: []
tags: []
paths:
  /partners/events/{eventId}/ticket-tiers/{tierKey}:
    patch:
      tags:
        - events-consumer
      summary: Update a ticket tier
      operationId: PartnerEventsController_updateTicketTier
      parameters:
        - name: eventId
          required: true
          in: path
          description: Event ID
          schema:
            example: evt_xyz789
            type: string
        - name: tierKey
          required: true
          in: path
          description: Ticket tier key
          schema:
            example: tier_abc123
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTicketTierDto'
      responses:
        '200':
          description: Ticket tier updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  eventId:
                    type: string
                    example: evt_techconf2025
                  tierKey:
                    type: string
                    example: tier_general_admission
                  tier:
                    type: object
                    properties:
                      key:
                        type: string
                        example: tier_general_admission
                      name:
                        type: string
                        example: General Admission
                      price:
                        type: number
                        example: 55
                      currency:
                        type: string
                        example: USD
                      capacity:
                        type: number
                        example: 120
                      min_tickets_per_order:
                        type: number
                        example: 1
                      max_tickets_per_order:
                        type: number
                        example: 20
                      sold_out:
                        type: boolean
                        example: false
                      group_booking_enabled:
                        type: boolean
                        example: true
                      group_discount_enabled:
                        type: boolean
                        example: false
                      discount_type:
                        type: string
                        example: PERCENTAGE
                      discount_value:
                        type: number
                        example: 10
                      service_fee_rate:
                        type: number
                        example: 0.05
                      show_remaining_tickets:
                        type: boolean
                        example: true
                      sale_start:
                        type: number
                        example: 1735651200000
                      sale_end:
                        type: number
                        example: 1735665600000
                  message:
                    type: string
                    example: Ticket tier updated
        '400':
          description: Invalid ticket tier data
        '401':
          description: Invalid or missing partner API key
        '403':
          description: Event not owned by partner
        '422':
          description: Validation failed or tier not found
      security:
        - access-token: []
        - partner-api-key: []
components:
  schemas:
    CreateTicketTierDto:
      type: object
      properties:
        name:
          type: string
          example: VIP
          description: The name of the ticket tier
        inclusions:
          type: string
          example: Free drinks, Front row seating
          description: Optional inclusions for this tier
        price:
          type: number
          example: 150
        currency:
          type: string
        capacity:
          type: number
          example: 100
        sold_out:
          type: boolean
          example: false
        min_tickets_per_order:
          type: number
          example: 1
        max_tickets_per_order:
          type: number
          example: 5
        group_booking_enabled:
          type: boolean
          example: false
        group_min_tickets:
          type: number
          example: 10
        group_discount_enabled:
          type: boolean
          example: false
        discount_type:
          type: string
          enum:
            - FIXED
            - PERCENTAGE
          example: PERCENTAGE
        service_fee_rate:
          type: number
          example: 0.05
          description: Decimal fee rate. If empty, the global default is used.
        discount_value:
          type: number
          example: 15
        sale_start:
          type: number
          example: 1783882800000
          description: Unix Timestamp (milliseconds)
        sale_end:
          type: number
          example: 1784487600000
          description: Unix Timestamp (milliseconds)
        show_remaining_tickets:
          type: boolean
          example: true
          description: Show remaining ticket count to customers
      required:
        - name
        - price
        - currency
        - capacity
        - min_tickets_per_order
        - max_tickets_per_order
        - group_booking_enabled
        - group_discount_enabled
        - sale_start
        - sale_end
  securitySchemes:
    access-token:
      scheme: bearer
      bearerFormat: JWT
      type: http
    partner-api-key:
      type: apiKey
      in: header
      name: x-partner-key
      description: Partner API Key (tk_live_... or tk_test_...)

````

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