Personal tools

switchvox.users.distinctiveRing.tones.remove

From SwitchvoxExtendAPI

Jump to: navigation, search

Contents

Description

Remove (delete) a ringtone from the user's library.

Arguments

See the Constructing Requests page to learn how to use arguments in requests.
Name Required Type Default Description
account_id yes integer (none) The account ID of the user ringtone library. Currently this must be the ID of the user making the request.
tone_id yes integer (none) The ID of the ringtone to remove

Example Requests & Responses

Please see the API Request and Response Format section for more information on various request encodings.

Request

<request method="switchvox.users.distinctiveRing.tones.remove" version="17487">
    <parameters>
        <tone_id>29</tone_id>
    </parameters>
</request>

Response

<response method="switchvox.users.distinctiveRing.tones.remove">
    <result>
        <success/>
    </result>
</response>

Error Codes

See the Error Code Formatting section to see the xml structure when an error is returned.
See the Generic Error Codes section to see a list of general fault codes that may be returned.
Code Description
83230 Unable to delete your ring tone at this time, please contact support.
69349 The ringtone could not be found in this ringtone library.
Retrieved from "http://developers.digium.com/switchvox/wiki/index.php/Switchvox.users.distinctiveRing.tones.remove"