Sign in

v1

latestSwagger 2.02026-07-1451115.7 KB
identity

Update the following status of the logged-in user for a particular aggregation

After a successful call, this returns a User document with an updated list of affiliations.

post/v2/following

Headers

Authorizationstring required

Your access token from the Authorization Service. Should start with Bearer, followed by a space, followed by the token.

Request body

daysSinceLastListeninteger

The number of days since a user last listened to a story from this aggregation. Absent if user never listened to the aggregation.

followingboolean required

Whether or not the user is following the aggregation. When changing affiliation status, the client is expected to toggle this value and then send the entire object back.

hrefstring required

A link to more details about the program from the NPR Story API

idstring required

A unique identifier for the aggregation (program)

notif_followingstring[]

The topic in Firebase Cloud Messaging to which the device should subscribe if it supports notifications and the user wants notifications about the podcasts they follow.

notif_ratedstring[]

The topic in Firebase Cloud Messaging to which the device should subscribe if it supports notifications and the user wants notifications about the podcasts they have highly rated.

ratingnumber float

The user's average rating for this affiliation on a scale of 0-1. Absent if user never listened to the aggregation.

titlestring

The title for the aggregation (program)

Response

The request was successful

errorsobject[] required

A list of encountered errors, ignored on POST, PUT

hrefstring required

A URL representation of the resource; should generally be ignored by clients unless noted otherwise

itemsobject[] required

Not used, ignored on a PUT

linksobject required

A list of links, not used by the Identity Service; ignored on a PUT

versionstring required

The version of the Collection.Doc+JSON spec being used

All 5 operations