Monthly Event Page

This section covers the API endpoints for managing monthly event pages in the admin panel.

Get Monthly Event

GET /v1/admin/pages/custom/monthly-events

Retrieve details of the monthly event page.

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "title": "الثراء",
        "description": "أنوي الثراء بأيسر الطرق وأفضل الاحتمالات",
        "key": "monthly-events",
        "meta": {
            "movie_description": "@NetflixMENA",
            "movie_title": "Get Smart With Money"
        },
        "movie_poster": "http://192.168.0.139:8080/storage/28582/بوستر.jpg",
        "note_file": "http://192.168.0.139:8080/storage/28628/مفكرة-الثراء.pdf",
        "backgrounds": [
            "http://192.168.0.139:8080/storage/6294/Fi6yI87UAAA6NKH.jpeg"
        ]
    },
    "status_code": 200
}

Update Monthly Event

PATCH /v1/admin/pages/custom/monthly-events

Update the monthly event page content.

Request Body

Parameter	Type	Description
title	string	Optional. Page title (3-255 characters)
description	string	Optional. Page description (min 3 characters)
meta	object	Optional. Additional metadata
meta.movie_title	string	Optional. Movie title (3-255 characters)
meta.movie_description	string	Optional. Movie description (min 3 characters)
movie_poster	file	Optional. Image file (jpeg, png, jpg). Max size: 1024KB
backgrounds	array	Optional. Array of background images (max 4 images)
backgrounds.*	file	Image file (jpeg, png, jpg). Max size: 1024KB
note_file	file	Optional. PDF file. Max size: 20MB
delete_note_file	boolean	Optional. Set to true to remove the existing note file

Response

{
    "success": true,
    "message": "تم تحديث البيانات بنجاح.",
    "data": {
        "title": "الدكتور4",
        "description": "ذلك ونحن نجد أن ما كان قد تعلمها من الحيوانات، ويجر يده على رأسه، ويمسح أعطافه. ويتملق إليه، ويظهر البشر والفرح به. حتى سكن جأش أسال وعلم أنه لا.",
        "key": "monthly-events",
        "meta": {
            "movie_description": "@NetflixMENA",
            "movie_title": "Get Smart With Money"
        },
        "movie_poster": "http://192.168.0.139:8080/storage/28582/بوستر.jpg",
        "note_file": "http://192.168.0.139:8080/storage/28628/مفكرة-الثراء.pdf",
        "backgrounds": [
            "http://192.168.0.139:8080/storage/6294/Fi6yI87UAAA6NKH.jpeg"
        ]
    },
    "status_code": 200
}

Authorization

All monthly event page endpoints require admin authorization. The user must have the appropriate permissions to perform these operations.

Notes

• The monthly event page is a singleton resource identified by the key 'monthly-events'
• Background images are limited to a maximum of 4 images
• Supported image formats: JPEG, PNG, JPG
• Maximum image file size: 1024KB
• Maximum PDF file size: 20MB
• When updating, only the provided fields will be modified