Skip to main content

Add/update activity day​

Create or update a daily activity record (one per date per type). Activity Days power streaks, goals, and calendar-style progress.

For type=QURAN, provide seconds, ranges, and mushafId. You can optionally pass date (YYYY-MM-DD) to backfill activity for a past day (for example when the user manually adds time). This endpoint enqueues progress updates and uses the x-timezone header to interpret day boundaries and calculate streaks accurately.

Header Parameters
    x-timezone string

    The current timezone of the user. Not providing the value might affect the accuracy of how we calculate days and streaks.

Request Body
    oneOf
    seconds integer required

    Possible values: >= 1

    Seconds spent reading the current request's ranges

    ranges string[] required

    Possible values: Value must match regular expression ^(\d+:\d+-\d+:\d+(?:,\d+:\d+-\d+:\d+)*)$

    Current request's read range of Ayahs

    mushafId integer required

    Possible values: [1, 2, 3, 4, 5, 6, 7, 11, 19]

    The id of the Mushaf being used.

    1 = QCFV2

    2 = QCFV1

    3 = Indopak

    4 = UthmaniHafs

    5 = KFGQPCHAFS

    6 = Indopak15Lines

    7 = Indopak16Lines

    11 = Tajweeed

    19 = QCFTajweedV4

    date string

    Possible values: Value must match regular expression ^\d{4}-\d{2}-\d{2}$

    The date of the activity day, can be today or a past date. If not passed, default to today

    type string required

    Possible values: [QURAN, LESSON, QURAN_READING_PROGRAM]

    The type of the activity day

Responses

Request has been handled successfully.

Schema
    success boolean
    data object
Loading...