Distribution - Delete Distribution

This guide explains how to delete a distribution link in EnterMediaDB using:

  • JSON REST API
  • EnterMediaDB API UI

Both methods perform the same operation.

1. Overview

The Delete Distribution API allows you to remove an existing distribution link.

This process deletes the distribution entry and disables access through the generated distribution URLs.

2. API Endpoint

The API endpoint is the URL used to run this operation via the REST API.

Endpoint:

DELETE /assets/mediadb/services/distribution/delete/{distributionid}

Example:

DELETE /assets/mediadb/services/distribution/delete/93caa502-139a-40c3-accb-5891076bb04a

This endpoint:

  • Processes a distribution delete request
  • Removes the specified distribution link

3. Required Parameters

The following parameters must be included in the request body:

  • distributionid: ID of the distribution link to delete

This value specifies which distribution should be removed.

4. Delete Distribution Using JSON REST API

Step 1: Prepare Your Data

Example:

93caa502-139a-40c3-accb-5891076bb04a
Step 2: Send the Request
curl -X DELETE \
  -H "Content-Type: application/json" \
  -b "entermedia.key=YOUR_SESSION_KEY" \
  "http://entermedia.org/assets/mediadb/services/distribution/delete/93caa502-139a-40c3-accb-5891
Notes
  • Replace YOUR_SESSION_KEY with your actual entermedia.key
  • Ensure your API session is initialized (see Authentication section)
  • Use -L if your server redirects to HTTPS
  • Deleting a distribution link disables access to the generated URLs

5. Delete Distribution Using EnterMediaDB API UI

You can delete a distribution link directly in the EnterMediaDB interface.

Steps

  1. Open the EnterMediaDB API UI

    Example:
    https://emedialibrary.org/mediadb

  2. In the left sidebar, navigate to:
     Distribution → Delete distribution

  3. In the URL field, enter the distribution ID at the end of the endpoint URL

Example:

/assets/mediadb/services/distribution/delete/93caa502-139a-40c3-accb-5891076bb04a

4. Click Execute

6. Response

A successful request returns:

{
  "response": {
    "status": "ok"
  }
}

8. What Happens After Distribution Deletion

After a successful request:

  • The distribution entry is removed
  • Distribution URLs are no longer accessible
  • External access to the shared asset is disabled

9. Troubleshooting

1. Distribution deletion fails
  • Check that distributionid is valid
  • Ensure the distribution exists
  • Verify API permissions are enabled
2. Unauthorized request
  • Ensure entermedia.key is included
  • Ensure session is initialized
  • Verify permissions
3. Distribution URL still works
  • Refresh the browser or clear cache
  • Verify the correct distribution ID was deleted
  • Allow time for CDN or cache invalidation if applicable