Admin - create a library item

POST

https://uat-api.hastaai.in/api/v1/library/panel

library

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

x-codeSamples:[{"lang":"cURL","source":"curl -X POST -H 'Authorization: Bearer <admin-token>' -d '{\"title\":\"King Rantideva\",\"content_type\":\"puranic_story\"}' /api/v1/library/panel"}]

Request: application/json

Create a new library item (slug auto-generated from title). Set is_active=true to publish immediately, or keep it a draft. Admin role required. Publishing notifies opted-in users and refreshes the content-types cache.

Body: title, content_type (required); source_name, content, meaning, explanation, real_world_example, is_premium, is_active (optional)

Success: 200 - created

Errors: 401 - invalid/expired token | 403 - not an admin | 409 - title already exists | 422 - invalid body

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "content": "<p>King Rantideva was renowned for...</p>",
    "content_type": "puranic_story",
    "explanation": "The story teaches selfless giving...",
    "is_active": false,
    "is_premium": false,
    "meaning": "True charity expects nothing in return...",
    "real_world_example": "Like a volunteer who...",
    "source_name": "Bhagavata Purana",
    "title": "The Story of King Rantideva"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://uat-api.hastaai.in/api/v1/library/panel' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "content": "<p>King Rantideva was renowned for...</p>",
    "content_type": "puranic_story",
    "explanation": "The story teaches selfless giving...",
    "is_active": false,
    "is_premium": false,
    "meaning": "True charity expects nothing in return...",
    "real_world_example": "Like a volunteer who...",
    "source_name": "Bhagavata Purana",
    "title": "The Story of King Rantideva"
}'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Library item created successfully"
}

🟠401Unauthorized

🟠403Forbidden

🟠409

🟠422Parameter Error

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

Admin - list library items (incl. drafts)

Admin - get a library item (incl. drafts)