This API you can change to the position of tag/tracks. The tag/tracks default position will be 1000.
In this API you need to pass three path parameters to change a tag/track's posiotion.
id :
Tag/Tracks' id whose position we are changing
topKeyValueId :
Id of tag/track below which current tag/track we want to place. Pass 0 if you want to move tag/track at top of the list.
topBottomKeyValueId:
Id of tag/track above which current tag/track we want to place. Pass 0 if you want to move tag/track at bottom of the list.
For example:
Let assume we have four tags called Tag-1, Tag-2, Tag-3, Tag-4.
Now if we want to move Tag-4 between Tag-2 and Tag-3 you need to send Tag-2's id as topKeyValueId and Tag-3's id as topBottomKeyValueId.
If we want to move Tag-2 to the last position then you need to send Tag-4's id as topKeyValueId and 0 as topBottomKeyValueId.
If we want to move Tag-1 to the first position then you need to send 0 as topKeyValueId and Tag-1 id as topBottomKeyValueId.
This API can be used by authenticated users only, and it will require super admin/admin/staff level access.
Here is the description of response attributes, which returns to the form of JSON.
| Attributes | Description |
|---|---|
| type | This field returns the type of message, like success or error. |
| message | This field returns a message description. |
This API Returns a void response with 200 status if the API executed successfully.
Here are the possible error messages, which return if any condition gets failed or required data is missing for processing.
| Error Code | Error Description |
|---|---|
| 400 | The request could not be understood by the server due to malformed syntax. |
| 401 | You are not authorized to view the resource. |
| 403 | Accessing the resource you were trying to reach is forbidden. |
| 404 | The resource you were trying to reach is not found. |