/

Docs
History
Schema
Generate

Filter operations

AppUser36

Artifact86

AuditLog1

ContributionStats4

DonationAccounting13

ExternalFTP3

FAQ14

Ganjoor214

GanjoorLiterary14

GanjoorLiteraryConceptAdmin2

GanjoorLiteraryStats3

GanjoorLiteraryTagSource3

GanjoorPoetSuggestedPhotos7

GanjoorPoetSuggestedSpecLines7

GanjoorRelatedPerson25

GeoLocation5

Image5

MusicCatalogue2

Notification10

Numbering9

Recitation41

get/api/audio/publishedreturns paginated published recitations (if poetId or catId is non-zero its ordered by poemId ascending if not it is ordered by publish date descending)
get/api/audio/published/{id}get published recitation by id
get/api/audio/published/rsscreates an RSS file from recent published recitations
get/api/audioGets audio narrations, user must have recitation::moderate permission to be able to see all users narrations (Auth)
post/api/audioReciation Upload (Auth)
get/api/audio/file/{id}.mp3get the corresponding mp3 file for the narration
get/api/audio/xml/{id}get the corresponding xml file contents (xml) for the narration
get/api/audio/file/{id}.xmlget the corresponding xml file for the recitation
get/api/audio/verses/{id}Gets Verse Sync Information
put/api/audio/{id}updates narration metadata (Auth)
delete/api/audio/{id}Delete a recitation (Auth)
put/api/audio/moderate/{id}Moderate pending narration (for moderating other users' recitations you also need recitation:moderate permission) (Auth policies: recitation:publish)
post/api/audio/{id}/xmlReplace the synchronization (xml) file of an already approved recitation belonging to the logged on user, without touching its mp3 file. Send the new xml as the single file in the request's form-data. The uploaded xml is only accepted if its embedded PoemId and audio checksum match the target recitation exactly (i.e. it must be a resync of the very same mp3 already on record) - this endpoint never accepts a new mp3. On acceptance, the xml is queued for re-publishing to the external FTP server(s) in the background and you receive a notification with the final result (success or failure). (Auth)
get/api/audio/uploadsGet User Uploads (Auth)
get/api/audio/uploadenabledupload, update, moderate and delete operations on recitations might temporarily become disabled, this method gets the current status remarks: the value of this flag is provided as a custom header called audio-upload-enabled in some common GET methods in order to reduce the need for a separate query (Auth)
get/api/audio/profileGet User Profiles (Auth)
put/api/audio/profileUpdate a narration profile (Auth)
post/api/audio/profileAdd a narration profile (Auth)
get/api/audio/profile/defGet User Default Profile (Auth)
delete/api/audio/profile/{id}Delete a narration profile (Auth)
get/api/audio/publishqueuepublishing tracker data (Auth)
put/api/audio/chownTransfer Recitations Ownership (for recitations owned by current user) (Auth)
get/api/audio/syncqueueSynchronization Queue (Auth)
get/api/audio/errors/reportget errors reported for recitations (Auth policies: recitation:moderate)
post/api/audio/errors/reportreport an error in a recitation (Auth)
delete/api/audio/errors/report/{id}reject a reported error for recitations and notify the reporter (and deletes the report) (Auth policies: recitation:moderate)
delete/api/audio/errors/report/accept/{id}accepts a reported error for recitations, change status of the recitation to rejected and notify the reporter and recitation owner (and deletes the report) (Auth policies: recitation:moderate)
put/api/audio/errors/report/saveaccepts a reported error for recitations, add mistake to approve the mistake and notify the reporter and recitation owner (and deletes the report) (Auth policies: recitation:moderate)
put/api/audio/errors/report/editedit approved mistake of a recitation text (Auth policies: recitation:moderate)
delete/api/audio/errors/approved/{id}remove approved mistake (Auth policies: recitation:moderate)
post/api/audio/vote/{id}up vote a recitation (Auth)
delete/api/audio/vote/{id}revoke recitaion up vote (Auth)
put/api/audio/vote/switch/{id}revoke recitaion up vote (Auth)
get/api/audio/votesget user upvoted recitations (Auth)
get/api/audio/votes/{poemId}/scorescompute poem recitations order (no update)
post/api/audio/healthcheckstarts checking recitaions with missing files and add them to reported errors list job (Auth policies: recitation:moderate)
post/api/audio/retrypublishretry publish unpublished narrations
put/api/audio/ffMakes recitations of فریدون فرح‌اندوز first recitations (Auth policies: recitation:import)
get/api/audio/cattop1/{catId}get category top one recitations
get/api/audio/catany/{catId}check if a category has any recitations
get/api/audio/cattop1/{catId}/rssrss for category top one recitations

RGenericOptions8

RImage2

RLongRunningJobs3

Role8

SemanticSearch2

SiteBanners5

Translation5

UserVisitsTracking4

Recitation

Changes to get published recitation by id

get/api/audio/published/{id}

Oct 27, 2026143b912b1085 Revision changes
- info
  added the optional property to the response with the status