Delete Member Media

From KickApps Documentation

Jump to: navigation, search

Contents

Overview

The Delete Member Media call lets you delete media items contributed by community members.

URI

Your request will look something like the following:

http://api.kickapps.com/rest/media/delete/{mediaType}/{mediaId}/{as}

Parameters

  • mediaType. The media type of the media that is being rejected. Possible values are: audio, video, blogs, sets, photo and page.
  • mediaId. The id of media that is being rejected.
  • as. The site id to search. AS is unique for each of the affiliate site.

Post Parameters

  • t. String. Required. Your access permissions.
  • callback. String. Optional. The name of your JavaScript callback function.
  • clientIP. String. Optional. Use the clientIP parameter to pass the IP address of the user making the call. If the IP has been blocked by the webmaster under the Affiliate Center -> Manage Members section, an error message will be returned starting with "status":"-1","error":"This IP address has been banned".

Payload

On success, a return that begins with "status":"1","message":"Media deleted successfully.".

If media is deleted an error that begins with "status":"-1","message":" Media does not exist." will be returned. If 'mediaId' and 'as' do not match, an error that begins with "status":"-1","message":" Media does not exist." will be returned.

Permissions

  • Webmasters can delete any media items for any AS ID to which they belong.
  • Admins can delete any media items within their AS ID, except those contributed by the Webmaster.
  • Editors can delete any media items within their AS ID, except those contributed by the Webmaster or an Admin.

When a user attempts to delete a media item for which s/he is not authorized, the following error will be returned: "Insufficient user permissions for this operation."

List of KickApps API Calls


Note: Occasionally (and without advanced warning) we modify our API calls by adding new parameters in the response payload. Please keep this in mind when designing your strategy for parsing our responses.