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

# Expedite purge on a trashed library

> Expedites the background purge on a **trashed** library: the 90-day undo window is waived and the drain begins claiming this library on the next scheduled tick. Returns immediately; the drain proceeds asynchronously in bounded batches and does not block on completion. `restore_library` still works until the drain finishes purging all assets, but past this point it will recover only the assets the drain hasn't gotten to yet. Returns 409 if the library has not been trashed yet — call `trash_library` first.



## OpenAPI

````yaml https://api.gumnut.ai/openapi.json delete /api/libraries/{library_id}
openapi: 3.1.0
info:
  title: Gumnut API
  description: API for using Gumnut to manage photos and videos
  version: 0.1.0
servers: []
security: []
paths:
  /api/libraries/{library_id}:
    delete:
      tags:
        - libraries
      summary: Expedite purge on a trashed library
      description: >-
        Expedites the background purge on a **trashed** library: the 90-day undo
        window is waived and the drain begins claiming this library on the next
        scheduled tick. Returns immediately; the drain proceeds asynchronously
        in bounded batches and does not block on completion. `restore_library`
        still works until the drain finishes purging all assets, but past this
        point it will recover only the assets the drain hasn't gotten to yet.
        Returns 409 if the library has not been trashed yet — call
        `trash_library` first.
      operationId: delete_library
      parameters:
        - name: library_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Library ID (with `lib_` prefix) of the trashed library to
              expedite.
            title: Library Id
          description: Library ID (with `lib_` prefix) of the trashed library to expedite.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletionResponse'
        '404':
          description: Not found
        '409':
          description: Library is not trashed
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    DeletionResponse:
      properties: {}
      type: object
      title: DeletionResponse
      description: >-
        Acknowledgment body returned by destructive endpoints (delete / trash /
        restore /

        permanently delete / remove-from-album / empty-trash).


        Carries no fields — the HTTP 200 + empty JSON object is itself the
        success

        signal. Exists so MCP tools generated from these endpoints have a real

        ``outputSchema`` (rather than the null schema FastMCP emits for 204

        responses), which ChatGPT's MCP submission tooling requires.
      x-stainless-empty-object: true
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````