Skip to content
Open Podcast API

Update a single subscription entry

PATCH
/v1/subscriptions/{guid}

Update information about a single subscription specified in the path

Authorizations

Parameters

Path Parameters

guid
required
string format: guid
Example
968cb508-803c-493c-8ff2-9e397dadb83c

Request Body

A request containing new information to update an existing subscription with

object
>= 1 properties
new_feed_url
string format: url
new_guid
string format: uuid
is_subscribed
boolean
{
  "new_feed_url": "https://example.com/rss5",
  "new_guid": "965fcecf-ce04-482b-b57c-3119b866cc61",
  "is_subscribed": false
}

Responses

200

Successful operation

object
>= 1 properties
new_feed_url
string format: url
is_subscribed
boolean
subscription_changed
string format: date-time
new_guid
string format: uuid
guid_changed
string format: date-time 
{
  "new_feed_url": "https://example.com/rss5",
  "is_subscribed": false,
  "subscription_changed": "2023-02-23T14:41:00.000Z",
  "guid_changed": "2023-02-23T14:41:00.000Z",
  "new_guid": "965fcecf-ce04-482b-b57c-3119b866cc61"
}

401

Unauthorized

object
code
required
string
message
required
string
Example
{
  "code": 401,
  "message": "User not authorized"
}

404

Not found

object
code
required
string
message
required
string
Example
{
  "code": 404,
  "message": "Resource not found"
}

405

Validation exception

object
code
required
string
message
required
string
Example
{
  "code": 405,
  "message": "Input could not be validated"
}