Add a library item to favourites

POST

https://uat-api.hastaai.in/api/v1/library/{slug}/favorite

library

Last modified:2026-08-18 09:16:20

x-codeSamples:[{"lang":"cURL","source":"curl -X POST -H 'Authorization: Bearer <token>' /api/v1/library/samudra-manthan/favorite"}]

Request: slug path param; Bearer token required

Adds the item to the signed-in user's favourites (idempotent).

Success: 200 - favourited. Also returns 200 with success: false and code: PLAN_LIMIT (not an HTTP error) when header X-Enforce-Paywall: true is sent and saved-items count has hit the plan's library_save limit (re-favoriting an already-saved item is always free)

Errors: 401 - invalid/expired token | 404 - item not found

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://uat-api.hastaai.in/api/v1/library//favorite' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Added to favourites"
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

Modified at 2026-08-18 09:16:20

List my favourite library items

Remove a library item from favourites