Skip to main content
POST
/
v1
/
favorites
Add Favorite
curl --request POST \
  --url https://api.thefaithapp.com/v1/favorites \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "media_id": 123
}
'
{
  "status": "<string>",
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.thefaithapp.com/llms.txt

Use this file to discover all available pages before exploring further.

Adds a media item to the authenticated member’s favorites.

​
Example request

{
  "media_id": 1
}

​
Request inputs

​
X-API-Key
string
required
Your client API key from the dashboard (Settings page).
​
media_id
number
required
Media ID to add to favorites.

​
Response fields

​
status
string
required
Indicates whether the favorite mutation completed successfully.
​
message
string
required
Confirms whether the media was added now or was already in the member’s favorites.

​
Example response

{
  "status": "Success",
  "message": "Media added to favorites"
}