मीरास API दस्तावेज़

सार्वजनिक, केवल-पठन API। ग़ैर-व्यावसायिक उपयोग के लिए नि:शुल्क, प्रति-IP दर-सीमित। नीचे दिया गया संदर्भ लाइव OpenAPI विनिर्देश से तैयार किया गया है; एंडपॉइंट और फ़ील्ड नाम भाषा-निरपेक्ष हैं।

इंटरैक्टिव कंसोल खोलें

Admin

get/admin/commentsList comments for moderation (offset paginated; filter by status/user/work/flagged/deleted)

पैरामीटर

Name	In	Required
page	query	—
pageSize	query	—
status	query	—
userId	query	—
workId	query	—
flagged	query

प्रतिक्रियाएँ

200 — A page of comments in admin shape.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
userId	string	yes
workId	string	yes
text	string	yes
status	string	yes
moderationReason	stringnull	yes
flagCount	number	yes
createdAt	string	yes

patch/admin/comments/{id}/approveApprove a pending comment

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The approved comment.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
userId	string	yes
workId	string	yes
text	string	yes
status	string	yes
moderationReason	stringnull	yes
flagCount	number	yes
createdAt	string	yes

त्रुटियाँ

403 — FORBIDDEN (non-admin)
404 — NOT_FOUND
409 — COMMENT_INVALID_TRANSITION (not pending)

patch/admin/comments/{id}/rejectReject a pending or approved comment (reason ≥ 20 chars)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
reason	string	yes

प्रतिक्रियाएँ

200 — The rejected comment.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
userId	string	yes
workId	string	yes
text	string	yes
status	string	yes
moderationReason	stringnull	yes

त्रुटियाँ

403 — FORBIDDEN (non-admin)
404 — NOT_FOUND
422 — VALIDATION_FAILED (reason too short)

patch/admin/comments/{id}/restoreRestore a soft-deleted comment

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The restored comment.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
userId	string	yes
workId	string	yes
text	string	yes
status	string	yes
moderationReason	stringnull	yes
flagCount	number	yes
createdAt	string	yes

त्रुटियाँ

403 — FORBIDDEN (non-admin)
404 — NOT_FOUND

get/admin/submissionsList submissions (admin; offset-paginated; FIFO by submittedAt; defaults to pending)

पैरामीटर

Name	In	Required
page	query	—
pageSize	query	—
status	query	—
entityType	query	—
submitterId	query	—
action	query	—

प्रतिक्रियाएँ

200 — A page of submissions.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
submitterId	string	yes
entityType	string	yes
entityId	stringnull	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN (not an admin)

patch/admin/submissions/{id}/approveApprove a pending submission — publishes the entity (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
notes	string	—

प्रतिक्रियाएँ

200 — The approved submission and the published entity.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

submission

object

yes

Field	Type	Required
_id	string	yes
submitterId	string	yes
entityType	string	yes
entityId	stringnull

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN (not an admin)
404 — NOT_FOUND
409 — SUBMISSION_INVALID_TRANSITION (not pending)
422 — SUBMISSION_INCOMPLETE

patch/admin/submissions/{id}/rejectReject a pending submission (admin; reason ≥ 20 chars)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
reason	string	yes

प्रतिक्रियाएँ

200 — The rejected submission.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
submitterId	string	yes
entityType	string	yes
entityId	stringnull	yes
action	string	yes
status	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN (not an admin)
404 — NOT_FOUND
409 — SUBMISSION_INVALID_TRANSITION (not pending)
422 — VALIDATION_FAILED (reason too short)

patch/admin/submissions/{id}/needs-revisionSend a pending submission back for revision (admin; notes ≥ 10 chars)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
notes	string	yes

प्रतिक्रियाएँ

200 — The submission, now needs_revision.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
submitterId	string	yes
entityType	string	yes
entityId	stringnull	yes
action	string	yes
status	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN (not an admin)
404 — NOT_FOUND
409 — SUBMISSION_INVALID_TRANSITION (not pending)
422 — VALIDATION_FAILED (notes too short)

post/admin/poetsCreate a poet (admin)

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

bioShort

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

bioFull

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

era

enum

yes

languagesWrittenIn

array<string>

yes

copyrightStatus

enum

yes

sourceAttribution

string

yes

प्रतिक्रियाएँ

201 — Poet created.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

name

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
409 — ALREADY_EXISTS
422 — VALIDATION_FAILED

patch/admin/poets/{id}Update a poet (admin, If-Match required)

पैरामीटर

Name	In	Required	Description
id	path	yes
If-Match	header	yes

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

—

name

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

bioShort

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

bioFull

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

era

enum

—

languagesWrittenIn

array<string>

—

copyrightStatus

enum

—

sourceAttribution

string

—

प्रतिक्रियाएँ

200 — Poet updated.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

name

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND
409 — VERSION_MISMATCH
422 — VALIDATION_FAILED (incl. missing If-Match)

delete/admin/poets/{id}Soft-delete a poet (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Poet soft-deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

patch/admin/poets/{id}/restoreRestore a soft-deleted poet (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — Poet restored.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

era

enum

yes

submissionStatus

string

yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

post/admin/worksCreate a work (admin, sher only in Phase 1)

अनुरोध बॉडी

Field

Type

Required

Description

type

enum

yes

poetId

string

yes

slug

string

yes

body

object

yes

Field	Type	Required
en	array<any>	yes
hi	array<any>	yes
ur	array<any>	yes

tags

array<string>

yes

language

enum

yes

sourceAttribution

string

yes

प्रतिक्रियाएँ

201 — Work created.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
type	enum	yes
poetId	string	yes
slug	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND (poet missing or not approved)
409 — ALREADY_EXISTS
422 — VALIDATION_FAILED (incl. non-sher type, zero tags)

patch/admin/works/{id}Update a work (admin, If-Match required)

पैरामीटर

Name	In	Required	Description
id	path	yes
If-Match	header	yes

अनुरोध बॉडी

Field

Type

Required

Description

poetId

string

—

slug

string

—

body

object

—

Field	Type	Required
en	array<any>	yes
hi	array<any>	yes
ur	array<any>	yes

tags

array<string>

—

language

enum

—

sourceAttribution

string

—

प्रतिक्रियाएँ

200 — Work updated.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
type	enum	yes
poetId	string	yes
slug	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND
409 — VERSION_MISMATCH
422 — VALIDATION_FAILED (incl. missing If-Match, immutable slug/poetId)

delete/admin/works/{id}Soft-delete a work (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Work soft-deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

patch/admin/works/{id}/restoreRestore a soft-deleted work (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — Work restored.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
type	enum	yes
poetId	string	yes
slug	string	yes
submissionStatus	string	yes
version	number	yes
createdAt	string	yes
updatedAt	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

post/admin/tagsCreate a tag (admin)

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

type

enum

yes

sortPriority

number

—

isFeatured

boolean

—

प्रतिक्रियाएँ

201 — Tag created.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

name

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
409 — ALREADY_EXISTS
422 — VALIDATION_FAILED

patch/admin/tags/{id}Update a tag (admin, If-Match required)

पैरामीटर

Name	In	Required	Description
id	path	yes
If-Match	header	yes

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

—

name

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

type

enum

—

sortPriority

number

—

isFeatured

boolean

—

प्रतिक्रियाएँ

200 — Tag updated.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

name

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND
409 — VERSION_MISMATCH
422 — VALIDATION_FAILED (incl. missing If-Match, immutable slug)

delete/admin/tags/{id}Soft-delete a tag (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Tag soft-deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

patch/admin/tags/{id}/restoreRestore a soft-deleted tag (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — Tag restored.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

type

enum

yes

isFeatured

boolean

yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

post/admin/lughatCreate a dictionary entry (admin)

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

yes

headword

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

meaning

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

partOfSpeech

stringnull

—

exampleSherId

stringnull

—

प्रतिक्रियाएँ

201 — Dictionary entry created.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

headword

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
409 — ALREADY_EXISTS
422 — VALIDATION_FAILED

patch/admin/lughat/{id}Update a dictionary entry (admin, If-Match required)

पैरामीटर

Name	In	Required	Description
id	path	yes
If-Match	header	yes

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

—

headword

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

meaning

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

partOfSpeech

stringnull

—

exampleSherId

stringnull

—

प्रतिक्रियाएँ

200 — Dictionary entry updated.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

headword

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND
409 — VERSION_MISMATCH
422 — VALIDATION_FAILED (incl. missing If-Match, immutable slug)

delete/admin/lughat/{id}Soft-delete a dictionary entry (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Dictionary entry soft-deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

patch/admin/lughat/{id}/restoreRestore a soft-deleted dictionary entry (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — Dictionary entry restored.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

headword

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

meaning

object

yes

Field	Type	Required

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

get/admin/works/{id}/glossesList a work's Lughat glosses (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The work's glosses.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

workId

string

yes

token

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

coupletIndex

number

yes

lineIndex

number

yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN

post/admin/works/{id}/glossesAdd a Lughat gloss to a work (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field

Type

Required

Description

token

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

coupletIndex

number

yes

lineIndex

number

yes

occurrence

number

—

dictionaryEntryId

stringnull

—

meaning

objectnull

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

displayPriority

number

—

प्रतिक्रियाएँ

201 — Gloss created.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

workId

string

yes

token

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
409 — ALREADY_EXISTS (token slot already annotated)
422 — VALIDATION_FAILED (incl. non-approved work, exactly-one-source rule)

delete/admin/works/{id}/glosses/{glossId}Remove a Lughat gloss from a work (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes
glossId	path	yes

प्रतिक्रियाएँ

204 — Gloss removed.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

get/admin/featured-todayList pinned featured-today days, newest first (admin)

पैरामीटर

Name	In	Required	Description
limit	query	—
cursor	query	—

प्रतिक्रियाएँ

200 — A page of pinned days.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
date	string	yes
topSherIds	array<string>	yes
featuredPoetId	string	yes
featuredCollectionId	stringnull	yes
recommendedPoetIds	array<string>	yes
createdBy	string	yes
createdAt	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN

post/admin/featured-todayPin a featured-today day (admin)

अनुरोध बॉडी

Field

Type

Required

Description

date

string

yes

topSherIds

array<string>

yes

featuredPoetId

string

yes

featuredCollectionId

stringnull

—

wordOfDay

object

yes

Field

Type

Required

Description

word

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

meaning

object

yes

Field	Type	Required	Description
en	string	yes
hi	string	yes

recommendedPoetIds

array<string>

yes

प्रतिक्रियाएँ

201 — Day pinned.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
date	string	yes
topSherIds	array<string>	yes
featuredPoetId	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
409 — ALREADY_EXISTS (date already pinned)
422 — VALIDATION_FAILED (bad date, wrong ref counts, missing sher/poet)

patch/admin/featured-today/{id}Update a pinned day (admin; date is immutable)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field

Type

Required

Description

date

string

—

topSherIds

array<string>

—

featuredPoetId

string

—

featuredCollectionId

stringnull

—

wordOfDay

object

—

Field

Type

Required

Description

word

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

meaning

object

yes

Field

recommendedPoetIds

array<string>

—

प्रतिक्रियाएँ

200 — Day updated.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
date	string	yes
topSherIds	array<string>	yes
featuredPoetId	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND
422 — VALIDATION_FAILED (immutable date, bad refs)

delete/admin/featured-today/{id}Delete a pinned day (admin, hard delete)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Day deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

get/admin/featured-today/calendarCalendar of pinned days over a range (default today + 14d), entries hydrated (admin)

पैरामीटर

Name	In	Required	Description
startDate	query	—
endDate	query	—

प्रतिक्रियाएँ

200 — Days in the range, each with its entry or null.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

days

array<object>

yes

Field	Type	Required	Description
date	string	yes
entry	object	—

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
422 — VALIDATION_FAILED (bad date format)

get/admin/featured-today/preview-todayToday's pinned day, hydrated (admin) — what the home page will show

प्रतिक्रियाएँ

200 — Today's hydrated entry, or null.

Field	Type	Required	Description
success	enum	yes
data	object	—

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN

get/admin/collectionsList collections including unpublished (admin, offset-paginated)

पैरामीटर

Name	In	Required
page	query	—
pageSize	query	—
category	query	—
isFeatured	query	—
includeDeleted	query	—

प्रतिक्रियाएँ

200 — A page of collections.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type	Required	Description
en	string	yes
hi	string	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN

post/admin/collectionsCreate a collection (admin)

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

yes

title

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

description

objectnull

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

works

array<object>

—

Field

Type

Required

Description

workId

string

yes

order

integer

yes

editorialNote

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

coverImageUrl

stringnull

—

coverColor

stringnull

—

category

enum

—

tags

array<string>

—

displayPriority

number

—

isFeatured

boolean

—

isPublished

boolean

—

प्रतिक्रियाएँ

201 — Collection created.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
409 — ALREADY_EXISTS
422 — VALIDATION_FAILED (bad works array, missing title)

get/admin/collections/{id}Get a collection by id with hydrated works (admin; incl. unpublished + soft-deleted)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The collection with hydrated works.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

category

enum

yes

isPublished

boolean

yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

patch/admin/collections/{id}Update a collection (admin, If-Match required)

पैरामीटर

Name	In	Required	Description
id	path	yes
If-Match	header	yes

अनुरोध बॉडी

Field

Type

Required

Description

slug

string

—

title

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

description

objectnull

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

works

array<object>

—

Field

Type

Required

Description

workId

string

yes

order

integer

yes

editorialNote

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

coverImageUrl

stringnull

—

coverColor

stringnull

—

category

enum

—

tags

array<string>

—

displayPriority

number

—

isFeatured

boolean

—

isPublished

boolean

—

प्रतिक्रियाएँ

200 — Collection updated.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND
409 — VERSION_MISMATCH
422 — VALIDATION_FAILED (incl. missing If-Match, immutable slug)

delete/admin/collections/{id}Soft-delete a collection (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Collection soft-deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

patch/admin/collections/{id}/restoreRestore a soft-deleted collection (admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — Collection restored.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

category

enum

yes

isPublished

boolean

yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

post/admin/collections/{id}/worksAdd a work to a collection (admin; appends or inserts at an order)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field

Type

Required

Description

workId

string

yes

order

integer

—

editorialNote

object

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

प्रतिक्रियाएँ

200 — The updated collection.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND (collection missing)
409 — ALREADY_EXISTS (work already in the collection)
422 — VALIDATION_FAILED (order collision, missing/unapproved work)

patch/admin/collections/{id}/works/reorderReorder a collection's works (admin; must cover every work)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field

Type

Required

Description

order

array<object>

yes

Field	Type	Required	Description
workId	string	yes
order	integer	yes

प्रतिक्रियाएँ

200 — The updated collection.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND
422 — VALIDATION_FAILED (incomplete mapping or duplicate order/workId)

delete/admin/collections/{id}/works/{workId}Remove a work from a collection (admin; the Work itself is untouched)

पैरामीटर

Name	In	Required	Description
id	path	yes
workId	path	yes

प्रतिक्रियाएँ

200 — The updated collection.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

category

enum

yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND (collection missing or work not in collection)

get/admin/related-worksList related-works links, offset-paginated, filterable by fromWorkId (admin)

पैरामीटर

Name	In	Required
page	query	—
pageSize	query	—
fromWorkId	query	—

प्रतिक्रियाएँ

200 — A page of links.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

fromWorkId

string

yes

toWorkId

string

yes

relationshipType

enum

yes

editorialNote

objectnull

yes

Field	Type	Required	Description
en	string

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN

post/admin/related-worksCreate a related-works link (admin)

अनुरोध बॉडी

Field

Type

Required

Description

fromWorkId

string

yes

toWorkId

string

yes

relationshipType

enum

yes

editorialNote

objectnull

—

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

bidirectional

boolean

—

displayPriority

number

—

प्रतिक्रियाएँ

201 — Link created.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
fromWorkId	string	yes
toWorkId	string	yes
relationshipType	enum	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
409 — ALREADY_EXISTS (duplicate from/to/type)
422 — VALIDATION_FAILED (self-reference, missing/unapproved work)

delete/admin/related-works/{id}Delete a related-works link (admin, hard delete)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Link deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN
404 — NOT_FOUND

Auth

get/auth/csrfBootstrap a CSRF token

Sets the `meeras_csrf` cookie and returns its value in the body. Frontend echoes the value in `X-CSRF-Token` on every state-changing request. CSRF-exempt (the bootstrapping endpoint).

प्रतिक्रियाएँ

200 — CSRF token issued.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required	Description
csrfToken	string	yes

post/auth/registerRegister a new user

Creates a user with `isEmailVerified=false` and queues a verification email. Rate-limited 5/15min per IP. No cookies set; user cannot log in until verified.

अनुरोध बॉडी

Field	Type	Required
email	string	yes
password	string	yes
displayName	string	yes

प्रतिक्रियाएँ

201 — Created.

Field	Type	Required	Description

post/auth/verify-emailVerify email + auto-login

Consumes the verification token, sets `isEmailVerified=true`, and issues access/refresh/csrf cookies (auto-login per BACKEND_ARCHITECTURE §4.4).

अनुरोध बॉडी

Field	Type	Required	Description
token	string	yes

प्रतिक्रियाएँ

200 — Verified + auto-logged in.

Field	Type	Required
success	enum	yes
data	object	yes

post/auth/resend-verificationResend a verification email (enumeration-safe)

Always returns 200 regardless of whether the email matches a real user (email enumeration prevention). Rate-limited 5/15min per IP.

अनुरोध बॉडी

Field	Type	Required	Description
email	string	yes

प्रतिक्रियाएँ

200 — OK (silent for unknown emails).

Field	Type	Required	Description
success	enum	yes
data	object	yes

post/auth/loginLog in with email + password

Issues access/refresh/csrf cookies on success. Unknown-email and wrong-password both return the same 401 INVALID_CREDENTIALS (email enumeration prevention). Rate-limited 10/15min per IP.

अनुरोध बॉडी

Field	Type	Required	Description
email	string	yes
password	string	yes

प्रतिक्रियाएँ

200 — Logged in.

Field	Type	Required	Description
success	enum	yes

post/auth/refreshRotate refresh token (with reuse detection)

Rotates the refresh JWT in the same family. Replaying a previously-rotated token triggers immediate family revocation and returns 401 REFRESH_REUSE_DETECTED. Rate-limited 30/15min per IP.

प्रतिक्रियाएँ

200 — Rotated.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required	Description
refreshed	enum	yes

त्रुटियाँ

post/auth/logoutLog out and revoke the refresh family

Revokes every refresh token in the current family with `revokeReason="logout"` and clears all three auth cookies. Idempotent.

प्रतिक्रियाएँ

200 — Logged out.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required	Description

त्रुटियाँ

403 — CSRF_FAILED

post/auth/request-password-resetRequest a password-reset email (enumeration-safe)

Always returns 200 regardless of whether the email matches a real user (email enumeration prevention). Rate-limited 5/15min per IP.

अनुरोध बॉडी

Field	Type	Required	Description
email	string	yes

प्रतिक्रियाएँ

200 — OK (silent for unknown emails).

Field	Type	Required	Description
success	enum	yes
data	object	yes

post/auth/reset-passwordReset password + revoke all refresh families

Sets a new password (subject to strength + common-list validation) and revokes EVERY refresh family for the user — all devices are logged out.

अनुरोध बॉडी

Field	Type	Required	Description
token	string	yes
newPassword	string	yes

प्रतिक्रियाएँ

200 — Password reset.

Field	Type	Required	Description
success	enum	yes

Collections

get/collectionsList published collections (public, cursor-paginated, filterable)

पैरामीटर

Name	In	Required
limit	query	—
cursor	query	—
category	query	—
isFeatured	query	—
tags	query	—
sort	query	—

प्रतिक्रियाएँ

200 — A page of collections.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

title

object

yes

Field	Type

त्रुटियाँ

422 — VALIDATION_FAILED (bad limit or unknown sort field)

get/collections/{slug}Get a published collection by slug with its works hydrated (public)

पैरामीटर

Name	In	Required	Description
slug	path	yes

प्रतिक्रियाएँ

200 — The collection with hydrated works.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Engagement

get/works/{id}/commentsList approved comments on a work (public; cursor-paginated; no-store)

पैरामीटर

Name	In	Required
id	path	yes
limit	query	—
cursor	query	—

प्रतिक्रियाएँ

200 — A page of approved comments with author displayName.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
userId	string	yes
workId	string	yes
text	string	yes
language	string	yes
status	string	yes
createdAt	string	yes

post/works/{id}/commentsPost a comment on a work (auth + verified email; rate limited; enters pending)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
text	string	yes
language	string	—

प्रतिक्रियाएँ

201 — The created (pending) comment.

patch/comments/{id}Edit your own still-pending comment (owner only)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
text	string	yes

प्रतिक्रियाएँ

200 — The updated comment.

Field	Type	Required	Description

delete/comments/{id}Soft-delete a comment (owner or admin)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Soft-deleted.

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN (not owner or admin)
404 — NOT_FOUND

post/works/{id}/likeLike a work (auth + verified email; per-user rate limited)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — Liked.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

delete/works/{id}/likeUnlike a work (idempotent; auth + verified email)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Unliked (idempotent — succeeds even if no like existed).

त्रुटियाँ

401 — UNAUTHORIZED

post/works/{id}/bookmarkBookmark a work (auth + verified email; per-user rate limited)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — Bookmarked.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

delete/works/{id}/bookmarkRemove a bookmark (idempotent; auth + verified email)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

204 — Un-bookmarked (idempotent — succeeds even if none existed).

त्रुटियाँ

401 — UNAUTHORIZED

Home

get/homeThe homepage's featured-today curation (today's pinned day, else the most recent).

प्रतिक्रियाएँ

200 — The featured-today payload, or null when nothing has ever been pinned.

Field

Type

Required

Description

success

enum

yes

data

objectnull

yes

Field

Type

Required

Description

date

string

yes

topSher

array<object>

yes

Field

Type

Required

Description

_id

string

yes

type

enum

yes

slug

string

yes

body

object

—

poet

object

yes

Field	Type	Required	Description
slug	string	yes
name	object	yes

featuredPoet

object

—

recommendedPoets

array<object>

yes

wordOfDay

object

yes

Field

Type

Required

Description

word

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

meaning

object

yes

Field

Lughat

get/lughatList dictionary entries (public, cacheable, searchable by q)

पैरामीटर

Name	In	Required
limit	query	—
cursor	query	—
q	query	—
sort	query	—

प्रतिक्रियाएँ

200 — A page of dictionary entries.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

headword

object

yes

Field	Type	Required	Description
en	string	yes
hi	string

त्रुटियाँ

422 — VALIDATION_FAILED (bad limit or unknown sort field)

get/lughat/{slug}Get a dictionary entry by slug (public, cacheable)

पैरामीटर

Name	In	Required	Description
slug	path	yes

प्रतिक्रियाएँ

200 — The dictionary entry.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

Me

get/me/submissionsList your own submissions (auth; cursor-paginated; filterable by status)

पैरामीटर

Name	In	Required
limit	query	—
cursor	query	—
status	query	—

प्रतिक्रियाएँ

200 — A page of your submissions.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
submitterId	string	yes
entityType	string	yes
entityId	stringnull	yes
action	string	yes
status	string	yes
reviewNotes	stringnull	yes

त्रुटियाँ

401 — UNAUTHORIZED

post/me/submissionsSave a new draft submission (poet role; 5/hour rate limit)

अनुरोध बॉडी

Field	Type	Required
entityType	string	yes
entityId	string	—
action	string	yes
payload	object	yes
licenseType	string	yes
licenseAttestation	string	yes

patch/me/submissions/{id}Edit your draft (owner only; requires If-Match version)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
payload	object	yes

प्रतिक्रियाएँ

200 — The updated draft.

Field	Type	Required	Description

delete/me/submissions/{id}Cancel your draft (soft-delete; owner only)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The cancelled (soft-deleted) submission.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

post/me/submissions/{id}/submitSubmit your draft for review (draft|needs_revision → pending)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The submission, now pending.

Field

Type

Required

Description

success

enum

yes

data

object

yes

get/me/bookmarksList your bookmarks with the embedded work + poet (auth; cursor-paginated)

पैरामीटर

Name	In	Required	Description
limit	query	—
cursor	query	—

प्रतिक्रियाएँ

200 — A page of your bookmarks.

Field	Type	Required	Description
success	enum	yes
data	array<object>	yes

Poets

get/poetsList poets (public, cursor-paginated, filterable by era/isFeatured/languagesWrittenIn)

पैरामीटर

Name	In	Required
limit	query	—
cursor	query	—
era	query	—
isFeatured	query	—
languagesWrittenIn	query	—
sort	query	—

प्रतिक्रियाएँ

200 — A page of poets.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

slug

string

yes

name

object

yes

Field	Type

त्रुटियाँ

422 — VALIDATION_FAILED (bad limit or unknown sort field)

get/poets/{slug}Get a poet by slug (public)

पैरामीटर

Name	In	Required	Description
slug	path	yes

प्रतिक्रियाएँ

200 — The poet.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type

get/poets/{slug}/worksList a poet's works (public, cursor-paginated, filterable by type)

पैरामीटर

Name	In	Required
slug	path	yes
limit	query	—
cursor	query	—
type	query	—
sort	query	—

प्रतिक्रियाएँ

200 — A page of the poet’s works.

Search

get/searchCross-script search over works (Atlas Search backed; optional auth; rate-limited)

पैरामीटर

Name	In	Required
q	query	yes
type	query	—
script	query	—
limit	query	—
cursor	query	—

प्रतिक्रियाएँ

200 — A page of matching works plus meta.search { query, totalHits, tookMs }.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
type	enum	yes
poetId	string	yes
slug	string	yes
body	object	—

त्रुटियाँ

422 — VALIDATION_FAILED (q missing or fewer than 2 chars)
429 — RATE_LIMITED (per-IP search ceiling exceeded)

Super-admin

get/super-admin/usersList users with search + role filter (super-admin only)

पैरामीटर

Name	In	Required
page	query	—
pageSize	query	—
q	query	—
role	query	—

प्रतिक्रियाएँ

200 — Paginated user rows (includes email for the super-admin context).

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
email	string	yes
displayName	string	yes
role	enum	yes
isEmailVerified	boolean	yes
lastLoginAt	stringnull	yes

त्रुटियाँ

401 — UNAUTHORIZED
403 — FORBIDDEN (actor is not a super_admin)
422 — VALIDATION_FAILED

post/super-admin/users/{id}/promoteChange a user’s role (super-admin only)

पैरामीटर

Name	In	Required	Description
id	path	yes

अनुरोध बॉडी

Field	Type	Required	Description
targetRole	enum	yes
reason	string	yes

प्रतिक्रियाएँ

200 — Role changed; returns the updated user.

get/super-admin/audit-logsList audit-log entries (super-admin only)

पैरामीटर

Name	In	Required
page	query	—
pageSize	query	—
actorId	query	—
actorRole	query	—
entityType	query	—
entityId	query	—
action

get/super-admin/audit-logs/{id}Get a single audit-log entry (super-admin only)

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — A single redacted audit-log entry.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

System

get/healthzLiveness probe

Returns 200 with process uptime and version. Used by orchestration platforms to confirm the process is running. Does not check downstream dependencies.

प्रतिक्रियाएँ

200 — The process is alive.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
status	enum	yes
uptime	number	yes
version	string	yes

get/readyzReadiness probe

Returns 200 once the process can serve traffic (Mongo connection healthy). Returns 503 SERVICE_UNAVAILABLE while the database is unreachable. Orchestration platforms route traffic based on this.

प्रतिक्रियाएँ

200 — Ready to serve traffic.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required	Description
status	enum	yes
uptime

Works

get/ghazalsList ghazals (public, cursor-paginated, newest-first, live poets only)

पैरामीटर

Name	In	Required	Description
limit	query	—
cursor	query	—

प्रतिक्रियाएँ

200 — A page of ghazals.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
type	enum	yes
poetId	string	yes
slug	string	yes
body	object	—
matlaCoupletIndex	numbernull	yes
maqtaCoupletIndex	numbernull	yes
language	string	yes

त्रुटियाँ

422 — VALIDATION_FAILED (bad limit or cursor)

get/ghazals/{id}Get a single ghazal by id (public), with embedded poet summary

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The ghazal.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

get/nazmsList nazms (public, cursor-paginated, newest-first, live poets only)

पैरामीटर

Name	In	Required	Description
limit	query	—
cursor	query	—

प्रतिक्रियाएँ

200 — A page of nazms.

Field	Type	Required	Description
success	enum	yes
data	array<object>	yes

get/nazms/{id}Get a single nazm by id (public), with embedded poet summary

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The nazm.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

get/sherSher feed (public): recent (cursor-paginated) or random; filterable by tag slugs / poetId

पैरामीटर

Name	In	Required
limit	query	—
cursor	query	—
mode	query	—
tags	query	—
poetId	query	—

प्रतिक्रियाएँ

200 — A page of sher (live poets only).

get/sher/{id}Get a single sher by id (public), with embedded poet summary

पैरामीटर

Name	In	Required	Description
id	path	yes

प्रतिक्रियाएँ

200 — The sher.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field

get/works/{id}/relatedPublic: related works for a work, hydrated with poet, in display-priority order

पैरामीटर

Name	In	Required	Description
id	path	yes
limit	query	—

प्रतिक्रियाएँ

200 — Related works (possibly empty).

Field	Type	Required	Description
success	enum	yes
data	array<object>	yes

Field

Type

Required

Description

user

object

yes

Field	Type	Required
_id	string	yes
displayName	string	yes
role	enum	yes
preferredScript	enum	yes
preferredUiLanguage	enum	yes
poetProfileId	stringnull	yes
isEmailVerified	boolean	yes
lastLoginAt	stringnull	yes
createdAt	string	yes
updatedAt	string	yes

Field

Type

Required

Description

user

object

yes

Field	Type	Required
_id	string	yes
displayName	string	yes
role	enum	yes
preferredScript	enum	yes
preferredUiLanguage	enum	yes
poetProfileId	stringnull	yes
isEmailVerified	boolean	yes
lastLoginAt	stringnull	yes
createdAt	string	yes
updatedAt	string	yes

_id

string

yes

slug

string

yes

title

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

description

objectnull

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

coverImageUrl

stringnull

yes

coverColor

stringnull

yes

category

enum

yes

tags

array<string>

yes

displayPriority

number

yes

isFeatured

boolean

yes

isPublished

boolean

yes

publishedAt

stringnull

yes

stats

object

yes

Field	Type	Required	Description
viewCount	number	yes

version

number

yes

createdAt

string

yes

updatedAt

string

yes

works

array<object>

yes

Field

Type

Required

Description

work

object

—

editorialNote

objectnull

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

order

number

yes

success

enum

yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

userId

string

yes

workId

string

yes

text

string

yes

language

string

yes

status

string

yes

createdAt

string

yes

user

objectnull

yes

Field	Type	Required	Description
displayName	string	yes

data

object

yes

Field

Type

Required

Description

_id

string

yes

userId

string

yes

workId

string

yes

text

string

yes

language

string

yes

status

string

yes

createdAt

string

yes

user

objectnull

yes

Field	Type	Required	Description
displayName	string	yes

_id

string

yes

slug

string

yes

headword

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

meaning

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

partOfSpeech

stringnull

yes

exampleSherId

stringnull

yes

submissionStatus

string

yes

version

number

yes

createdAt

string

yes

updatedAt

string

yes

प्रतिक्रियाएँ

201 — The created draft.

Field

Type

Required

Description

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
submitterId	string	yes
entityType	string	yes
entityId	stringnull	yes
action	string	yes
status	string	yes
reviewNotes	stringnull	yes
revisionNotes	stringnull	yes
submittedAt	stringnull	yes
version	number	yes
createdAt	string	yes

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
submitterId	string	yes
entityType	string	yes
entityId	stringnull	yes
action	string	yes
status	string	yes
reviewNotes	stringnull	yes
revisionNotes	stringnull	yes
submittedAt	stringnull	yes
version	number	yes
createdAt	string	yes

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
type	enum	yes
poetId	string	yes
slug	string	yes
body	object	—
language	string	yes
submissionStatus	string	yes
isFeatured	boolean	yes
createdAt	string	yes
updatedAt	string	yes

success

enum

yes

data

object

yes

Field	Type	Required
_id	string	yes
displayName	string	yes
role	enum	yes
preferredScript	enum	yes
preferredUiLanguage	enum	yes
poetProfileId	stringnull	yes
isEmailVerified	boolean	yes
createdAt	string	yes
updatedAt	string	yes

प्रतिक्रियाएँ

200 — Paginated, redacted audit-log entries.

Field

Type

Required

Description

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

actorId

string

yes

actorRole

enum

yes

action

string

yes

entityType

string

yes

entityId

string

yes

before

object

—

after

object

—

metadata

objectnull

yes

createdAt

string

yes

actor

objectnull

yes

Field	Type	Required	Description
displayName	string	yes

entityLabel

stringnull

yes

_id

string

yes

actorId

string

yes

actorRole

enum

yes

action

string

yes

entityType

string

yes

entityId

string

yes

before

object

—

after

object

—

metadata

objectnull

yes

createdAt

string

yes

actor

objectnull

yes

Field	Type	Required	Description
displayName	string	yes

entityLabel

stringnull

yes

_id

string

yes

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

description

objectnull

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

type

enum

yes

coverImageUrl

stringnull

yes

sortPriority

number

yes

isFeatured

boolean

yes

stats

object

yes

Field	Type	Required	Description
workCount	number	yes
poetCount	number	yes

createdAt

string

yes

updatedAt

string

yes

recentWorksCount

number

yes

success

enum

yes

data

array<object>

yes

Field	Type	Required
_id	string	yes
type	enum	yes
poetId	string	yes
slug	string	yes
body	object	—
language	string	yes
submissionStatus	string	yes
isFeatured	boolean	yes
createdAt	string	yes
updatedAt	string	yes

_id

string

yes

type

enum

yes

poetId

string

yes

slug

string

yes

body

object

—

matlaCoupletIndex

numbernull

yes

maqtaCoupletIndex

numbernull

yes

language

string

yes

submissionStatus

string

yes

isFeatured

boolean

yes

poet

object

yes

Field

Type

Required

Description

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

createdAt

string

yes

updatedAt

string

yes

Field

Type

Required

Description

_id

string

yes

type

enum

yes

poetId

string

yes

slug

string

yes

body

object

—

language

string

yes

submissionStatus

string

yes

isFeatured

boolean

yes

poet

object

yes

Field

Type

Required

Description

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

createdAt

string

yes

updatedAt

string

yes

_id

string

yes

type

enum

yes

poetId

string

yes

slug

string

yes

body

object

—

language

string

yes

submissionStatus

string

yes

isFeatured

boolean

yes

poet

object

yes

Field

Type

Required

Description

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

createdAt

string

yes

updatedAt

string

yes

success

enum

yes

data

array<object>

yes

Field

Type

Required

Description

_id

string

yes

type

enum

yes

poetId

string

yes

slug

string

yes

body

object

—

language

string

yes

submissionStatus

string

yes

isFeatured

boolean

yes

poet

object

yes

Field

Type

Required

Description

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

createdAt

string

yes

updatedAt

string

yes

_id

string

yes

type

enum

yes

poetId

string

yes

slug

string

yes

body

object

—

language

string

yes

submissionStatus

string

yes

isFeatured

boolean

yes

poet

object

yes

Field

Type

Required

Description

slug

string

yes

name

object

yes

Field	Type	Required
en	string	yes
hi	string	yes
ur	string	yes

createdAt

string

yes

updatedAt

string

yes