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

# Bulk trash assets

> Moves several assets to the trash in one request. Trashing is the soft-delete step; to remove assets for good, use [Bulk delete assets](/api-reference/assets/bulk-delete-assets).



## OpenAPI

````yaml openapi.json POST /api/v1/assets/bulk-trash
openapi: 3.0.3
info:
  title: Media Cloud API
  version: 1.0.0
  description: >-
    Upload, list, fetch and delete media assets on Media Cloud.


    All routes are mounted under `/api/v1` and authenticated with an API key
    sent as a Bearer token. Responses use the JSON:API media type,
    `application/vnd.api+json`: a resource is `{ id, type, attributes }` inside
    a `data` member, and lists add `links` and `meta` for pagination.
  contact:
    name: Media Cloud
    url: https://mediacloud.me
servers:
  - url: https://api.mediacloud.me
    description: Media Cloud API
security:
  - bearerAuth: []
tags:
  - name: Assets
    description: Upload, retrieve, trash and permanently delete files.
paths:
  /api/v1/assets/bulk-trash:
    post:
      tags:
        - Assets
      summary: Bulk trash assets
      description: >-
        Moves several assets to the trash in one request. Trashing is the
        soft-delete step; to remove assets for good, use [Bulk delete
        assets](/api-reference/assets/bulk-delete-assets).
      operationId: bulkTrashAssets
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkAssetIds'
            example:
              asset_ids:
                - 01a0bd9a-ddf1-70f7-ab61-b73fe0c35428
      responses:
        '204':
          description: The assets were moved to the trash. The response has no body.
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    BulkAssetIds:
      type: object
      required:
        - asset_ids
      properties:
        asset_ids:
          type: array
          description: The `id` of each asset to act on.
          items:
            type: string
            format: uuid
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key as a Bearer token: `Authorization: Bearer YOUR_API_KEY`.'

````

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