PUT Audio Position in a Podcast
Overview
The following table contains important information about the PUT
method for managing the process of changing the position of an audio in a podcast
PUT Audio Position in a Podcast | |
---|---|
Method | PUT |
URL or Endpoint | /api/v1/projectId /podcasts/audios |
Parameters | projectId |
Body | Check the body below |
The description of the URL parameters is as follows:
URL Parameter Name | Mandatory | Type | Description |
---|---|---|---|
projectId | Yes | string | Unique Id of the project. |
Request Body
{
"podcastId": "string",
"positionFrom": 0,
"positionTo": 0
}
Information about the fields that appear on the response body are displayed in the table below.
Parameter Name | Mandatory | Type | Description |
---|---|---|---|
podcastId | Yes | string | The unique identifier for the podcast. |
positionFrom | Yes | integer | The current position of the audio in the podcast. |
positionTo | Yes | integer | The new desired position for the audio in the podcast. |
Response
{
"success": true,
"errors": [],
"messages": [],
"result": {
"podcastId": "{podcastId}",
"positionFrom": 0,
"positionTo": 1
},
"resultInfo": null,
"statusCode": 200
}
Information about the fields that appear when you receive the response are displayed in the table below.
Field Name | Type | Description |
---|---|---|
success | bool | If the response is successful, it will return true. Otherwise, it will return false. |
errors | array[string] | Indicates if there was an error. |
messages | array[string] | Returns the response message from the backend. |
result | object | Returns the response object containing the detailed result. |
podcastId | string | The unique identifier for the podcast. |
positionFrom | integer | The current position of the audio in the podcast. |
positionTo | integer | The new desired position for the audio in the podcast. |
resultInfo | object | Additional information about the result |
statusCode | integer | The HTTP status code of the response. |
If the action is successful, the service sends back an HTTP 200 or 201 response.
Errors
For information about the errors that are common to all actions, see Common Errors:
HTTP Status Code 400: Bad Request
HTTP Status Code 401: Unauthorized
HTTP Status Code 403: Forbidden
HTTP Status Code 404: Result Not Found
HTTP Status Code 500: Internal Server Error
HTTP Status Code 503: Backend Fetch Faileds