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

# Delete a playlist group

> Delete a playlist group. Playlists in the group are not deleted, they just become ungrouped.



## OpenAPI

````yaml /openapi.json delete /v1/playlist-groups/{id}
openapi: 3.0.3
info:
  description: >-
    The Tella Public API allows you to programmatically access your videos and
    playlists, including transcripts, chapters, and thumbnails.


    ## Authentication


    All requests require a Bearer token in the Authorization header:

    ```

    Authorization: Bearer tella_pk_xxxxx...

    ```


    API keys can be generated in your Tella workspace settings.


    ## Rate Limiting


    The API is rate-limited to 100 requests per minute per organization.

    Rate limit information is returned in response headers:

    - `X-RateLimit-Limit`: Maximum requests per window

    - `X-RateLimit-Remaining`: Remaining requests in current window

    - `X-RateLimit-Reset`: Unix timestamp when the window resets
  title: Tella Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.tella.com
security: []
tags:
  - description: Video operations
    name: Videos
  - description: Sections of a video
    name: Clips
  - description: Playlist operations
    name: Playlists
  - description: Sidebar groups for organizing playlists
    name: Playlist Groups
  - description: Webhook endpoint management
    name: Webhooks
paths:
  /v1/playlist-groups/{id}:
    delete:
      tags:
        - Playlist Groups
      summary: Delete a playlist group
      description: >-
        Delete a playlist group. Playlists in the group are not deleted, they
        just become ungrouped.
      operationId: deletePlaylistGroup
      parameters:
        - description: Unique playlist group identifier
          in: path
          name: id
          required: true
          schema:
            description: Unique playlist group identifier
            example: pg_abc123def456
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Playlist group successfully deleted
        '400':
          content:
            application/json:
              example:
                error:
                  code: bad_request
                  doc_url: https://tella.tv/docs/api-reference/errors#bad-request
                  message: The request was malformed or contained invalid parameters.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The request was malformed or contained invalid parameters.
        '401':
          content:
            application/json:
              example:
                error:
                  code: unauthorized
                  doc_url: https://tella.tv/docs/api-reference/errors#unauthorized
                  message: Authentication is required. Provide a valid API key.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Authentication is required. Provide a valid API key.
        '403':
          content:
            application/json:
              example:
                error:
                  code: forbidden
                  doc_url: https://tella.tv/docs/api-reference/errors#forbidden
                  message: You don't have permission to access this resource.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: You don't have permission to access this resource.
        '404':
          content:
            application/json:
              example:
                error:
                  code: not_found
                  doc_url: https://tella.tv/docs/api-reference/errors#not-found
                  message: The requested resource was not found.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The requested resource was not found.
        '422':
          content:
            application/json:
              example:
                error:
                  code: unprocessable_entity
                  doc_url: >-
                    https://tella.tv/docs/api-reference/errors#unprocessable-entity
                  message: The request was well-formed but contained semantic errors.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The request was well-formed but contained semantic errors.
        '429':
          content:
            application/json:
              example:
                error:
                  code: rate_limit_exceeded
                  doc_url: >-
                    https://tella.tv/docs/api-reference/errors#rate-limit-exceeded
                  message: You have exceeded the rate limit. Please slow down.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: You have exceeded the rate limit. Please slow down.
        '500':
          content:
            application/json:
              example:
                error:
                  code: internal_server_error
                  doc_url: >-
                    https://tella.tv/docs/api-reference/errors#internal-server-error
                  message: An unexpected error occurred on the server.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: An unexpected error occurred on the server.
      security:
        - BearerAuth: []
components:
  schemas:
    SuccessResponse:
      additionalProperties: false
      description: Standard success response for operations that don't return data
      properties:
        status:
          description: Operation status
          enum:
            - ok
          example: ok
          type: string
      required:
        - status
      type: object
    ErrorResponse:
      additionalProperties: false
      description: Standard error response format
      properties:
        error:
          additionalProperties: false
          description: Error details
          properties:
            code:
              description: Machine-readable error code
              enum:
                - bad_request
                - unauthorized
                - forbidden
                - not_found
                - unprocessable_entity
                - rate_limit_exceeded
                - internal_server_error
              example: not_found
              type: string
            doc_url:
              description: Link to documentation for this error
              example: https://tella.tv/docs/api-reference/errors#not-found
              format: uri
              type: string
            message:
              description: Human-readable error message
              example: The requested resource was not found.
              type: string
          required:
            - code
            - message
            - doc_url
          type: object
      required:
        - error
      type: object
  securitySchemes:
    BearerAuth:
      description: API key obtained from your Tella account settings
      scheme: bearer
      type: http

````