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

# Delete Tournament API

> Deletes a tournament in the `future` state. Tournaments that are live or have ended cannot be deleted.

<Note>Tournaments module is only available with paid plans. [Contact us](https://business.gamezop.com/contact-us/enquire-now) to know more.</Note>

## About this API

Deletes a tournament you created — useful when a tournament was created in error.

<Warning>
  Only tournaments in the `future` state can be deleted. Once a tournament is `live` or has ended, deletion is blocked and returns a `409` error.
</Warning>

***

## API specification


## OpenAPI

````yaml /openapi-gzp.json delete /v2/tournaments/{tournament_id}
openapi: 3.1.0
info:
  title: Gamezop APIs
  version: 1.0.0
  description: >-
    OpenAPI specification for Gamezop endpoints including game catalog,
    leaderboard metadata, and other integration APIs.
servers:
  - url: https://api.gamezop.com
    description: Gamezop API
security:
  - bearerAuth: []
paths:
  /v2/tournaments/{tournament_id}:
    delete:
      summary: Delete Tournament API
      description: >-
        Deletes a tournament in the `future` state. Tournaments that are live or
        have ended cannot be deleted.
      operationId: deleteTournament
      parameters:
        - name: tournament_id
          in: path
          required: true
          description: The tournament to delete.
          schema:
            type: string
          example: tour_01HZZ2S9GQK6Y3V2S8D7A9F2BC
      responses:
        '200':
          description: Tournament deleted successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      tournament_id:
                        type: string
                        description: The deleted tournament's identifier.
                      deleted:
                        type: boolean
                        description: Always `true` on success.
              examples:
                sample:
                  summary: Example response
                  value:
                    success: true
                    data:
                      tournament_id: tour_01HZZ2S9GQK6Y3V2S8D7A9F2BC
                      deleted: true
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TournamentErrorResponse'
              examples:
                UNAUTHORIZED:
                  summary: Invalid or missing token
                  value:
                    code: UNAUTHORIZED
                    message: Invalid or missing token.
                    success: false
        '403':
          description: Forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TournamentErrorResponse'
              examples:
                TOURNAMENT_NOT_ALLOWED:
                  summary: Token does not have access to this tournament
                  value:
                    code: TOURNAMENT_NOT_ALLOWED
                    message: Your token does not have access to this tournament.
                    success: false
        '404':
          description: Not Found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TournamentErrorResponse'
              examples:
                TOURNAMENT_NOT_FOUND:
                  summary: Tournament does not exist or was already deleted
                  value:
                    code: TOURNAMENT_NOT_FOUND
                    message: Tournament does not exist or was already deleted.
                    success: false
        '409':
          description: Conflict.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TournamentErrorResponse'
              examples:
                TOURNAMENT_NOT_DELETABLE:
                  summary: Tournament is already live or has ended
                  value:
                    code: TOURNAMENT_NOT_DELETABLE
                    message: Tournament is already live or has ended.
                    success: false
        '429':
          description: >-
            Too Many Requests. Standard platform rate limits apply to this
            endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TournamentErrorResponse'
              examples:
                RATE_LIMIT_EXCEEDED:
                  summary: Too many requests
                  value:
                    code: RATE_LIMIT_EXCEEDED
                    message: >-
                      Too many requests. Standard platform rate limits apply to
                      this endpoint.
                    success: false
components:
  schemas:
    TournamentErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: Machine-readable error code identifying the failure.
        message:
          type: string
          description: Human-readable description of the error.
        success:
          type: boolean
          description: Boolean value that is always `false` in error responses.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: UUID
      description: >-
        You can find the Bearer token for this API under Settings & Admin > API
        Tokens within the [Gamezop Business
        Dashboard](https://dashboard.gamezop.com).

````