---
title: "Delete asset"
url: "https://earlyaccess.developers.bynder.com/apis/asset-management-api-1/versions/b623ec0a-a559-4667-a0ee-28fa2b9cd7ce/paths/api-v4-media-id/delete"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/asset-management-api-1/versions/b623ec0a-a559-4667-a0ee-28fa2b9cd7ce.md

# Delete asset

`DELETE` `/api/v4/media/{id}`

Requires the **MEDIAREMOVE** security role.

## Path parameters

- `id` (string, required) - Asset id.

## Header parameters

- `Authorization` (string, required) - OAuth 2.0 Bearer access token.

## Responses

- `204` - No Content
- `403` - Access denied
- `404` - Media not found

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Asset Management API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/media/{id}:
    delete:
      description: Requires the **MEDIAREMOVE** security role.
      parameters:
        - description: OAuth 2.0 Bearer access token.
          in: header
          name: Authorization
          required: true
          schema:
            type: string
        - description: Asset id.
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "403":
          content:
            application/json:
              schema:
                properties:
                  message:
                    type: string
                  statuscode:
                    type: string
                type: object
          description: Access denied
        "404":
          content:
            application/json:
              schema:
                properties:
                  message:
                    type: string
                  statuscode:
                    type: string
                type: object
          description: Media not found
      security:
        - permanentToken:
            - ""
            - MEDIAREMOVE
        - OAuth2:
            - ""
            - MEDIAREMOVE
      summary: Delete asset
      tags:
        - Media ID
security:
  - permanentToken:
      - ""
      - MEDIAREMOVE
  - OAuth2:
      - ""
      - MEDIAREMOVE
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            ARCHIVEDOWNLOAD: ""
            ARCHIVEMEDIA: ""
            EMARGOMEDIA: ""
            KEYVISUALDOWNLOAD: ""
            MARKPUBLIC: ""
            MEDIAEDIT: ""
            MEDIAREMOVE: ""
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            ARCHIVEDOWNLOAD: ""
            ARCHIVEMEDIA: ""
            EMARGOMEDIA: ""
            KEYVISUALDOWNLOAD: ""
            MARKPUBLIC: ""
            MEDIAEDIT: ""
            MEDIAREMOVE: ""
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```