Awareness Level

This section covers the API endpoints for managing awareness levels in the admin panel.

List Awareness Levels

GET /v1/admin/awareness-levels

Returns a paginated list of all awareness levels.

Query Parameters

Parameter	Type	Description
search_text	string	Search awareness levels by name
filter[active]	boolean	Filter by active status
filter[name]	string	Filter by exact name match
filter[trashed]	boolean	Include trashed awareness levels
sort	string	Sort by field (prefix with - for descending)
per_page	integer	Number of items per page. Defaults to 10
list	boolean	Return simplified list format

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://testing-api.sumaya369.net/v1/admin/awareness-levels?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http://testing-api.sumaya369.net/v1/admin/awareness-levels?page=1",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/admin/awareness-levels?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "http://testing-api.sumaya369.net/v1/admin/awareness-levels",
        "per_page": 10,
        "prev_page_url": null,
        "to": 6,
        "total": 6,
        "awarenessLevels": [
            {
                "id": "49cce7f0-f948-11ef-9495-816713301505",
                "name": "متقدم",
                "active": true,
                "created_at": "2025-03-05 01:30:34",
                "updated_at": "2025-03-05 01:30:34"
            },
            {
                "id": "44cc4ec0-f948-11ef-9acb-9952c73b0575",
                "name": "اعلى من المتوسط",
                "active": true,
                "created_at": "2025-03-05 01:30:25",
                "updated_at": "2025-03-05 01:30:25"
            },
            {
                "id": "3e45df80-f948-11ef-a9fb-6db8a4d6525a",
                "name": "متوسط",
                "active": true,
                "created_at": "2025-03-05 01:30:14",
                "updated_at": "2025-03-05 01:30:14"
            },
            {
                "id": "38039c50-f948-11ef-971f-3d54dea11ba1",
                "name": "مبتدئ",
                "active": true,
                "created_at": "2025-03-05 01:30:04",
                "updated_at": "2025-03-05 01:30:04"
            },
            {
                "id": "eaa75360-ef58-11ef-9a4a-ef8fd9c3009f",
                "name": "الوعي الجسدي",
                "active": true,
                "created_at": "2025-02-20 10:04:24",
                "updated_at": "2025-02-20 10:04:24"
            },
            {
                "id": "e6bdd090-ef58-11ef-84c5-73edad788685",
                "name": "الوعي الطاقي",
                "active": true,
                "created_at": "2025-02-20 10:04:17",
                "updated_at": "2025-02-20 10:04:17"
            }
        ]
    },
    "status_code": 200
}

Create Awareness Level

POST /v1/admin/awareness-levels

Create a new awareness level.

Request Body

Parameter	Type	Description
name	string	Required. Awareness level name (3-255 characters)
active	boolean	Required. Awareness level active status

Response

{
    "success": true,
    "message": "تم حفظ البيانات بنجاح.",
    "data": {
        "id": "ee555fe0-07e9-11f0-90fb-6b14b642055f",
        "name": "الوعي السبيستوني",
        "active": true,
        "created_at": "2025-03-23 16:22:55",
        "updated_at": "2025-03-23 16:22:55"
    },
    "status_code": 200
}

Get Awareness Level

GET /v1/admin/awareness-levels/{id}

Retrieve details of a specific awareness level.

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "49cce7f0-f948-11ef-9495-816713301505",
        "name": "متقدم",
        "active": true,
        "created_at": "2025-03-05 01:30:34",
        "updated_at": "2025-03-05 01:30:34"
    },
    "status_code": 200
}

Update Awareness Level

PATCH /v1/admin/awareness-levels/{id}

Update an existing awareness level.

Request Body

Parameter	Type	Description
name	string	Optional. Awareness level name (3-255 characters)
active	boolean	Optional. Awareness level active status

Response

{
    "success": true,
    "message": "تم تحديث البيانات بنجاح.",
    "data": {
        "id": "ee555fe0-07e9-11f0-90fb-6b14b642055f",
        "name": "الوعي 2",
        "active": true,
        "created_at": "2025-03-23 16:22:55",
        "updated_at": "2025-03-23 16:24:22"
    },
    "status_code": 200
}

Delete Awareness Levels

DELETE /v1/admin/awareness-levels

Delete one or more awareness levels.

Request Body

Parameter	Type	Description
ids	array	Required. Array of awareness level UUIDs to delete

Response

{
    "success": true,
    "message": "تم حذف البيانات بنجاح.",
    "data": null,
    "status_code": 200
}

Authorization

All awareness level endpoints require admin authorization. The user must have the appropriate permissions to perform these operations.

Notes

• Awareness levels with existing courses cannot be deleted
• Name must be unique across all awareness levels