Overview The landing page is a single record per company (or a single global record depending on your deployment).
It includes sections like:

Header + header images
Featured categories
Trainings and exams showcased on the landing page
Partner companies
Banner + banner image
Footer data
Quick links and social links

Common Headers Most endpoints require authentication.

Name	Value
Content-Type	application/json
Authorization Type	Bearer Token
Auth Credential	`{{token}}`

For endpoints that upload images, use:

Name	Value
Content-Type	multipart/form-data

Get Landing Page

GET /api/landing-page Retrieves the landing page with all related content. Included Relationships The response includes:

links
featuredCategories + feat_category_image
partnerCompanies + companyLogo
trainings (with instructor + images)
exams (with instructor + images)
headerImage, backgroundImage, bannerImage

Featured categories and partner companies are ordered by pivot_position. Response

✅ 200 OK

{
  "id": 1,
  "company_id": 10,
  "company_name": "My Company",
  "show_header_section": true,
  "featured_categories": [],
  "partner_companies": [],
  "trainings": [],
  "exams": [],
  "headerImage": {
    "id": 12,
    "file_name": "1700000000_header.png",
    "url": "https://example.com/storage/files/1700000000_header.png"
  }
}

Update Landing Page (Create or Update)

POST /api/landing-page Creates or updates the landing page for the authenticated user’s company. Authentication & Company Rules

Returns 401 if unauthenticated
Returns 403 if user does not have company_id

Body (Validation Rules)

Section Toggles (Booleans)

Field	Type	Required	Description
show_header_section	boolean	❌ No	Show/hide header section
show_category_section	boolean	❌ No	Show/hide featured categories
show_training_section	boolean	❌ No	Show/hide trainings section
show_exams_section	boolean	❌ No	Show/hide exams section
show_partner_company_section	boolean	❌ No	Show/hide partner companies
show_banner	boolean	❌ No	Show/hide banner

Company Content

Field	Type	Required	Description
company_name	string	❌ No	Landing page company name
company_description	string	❌ No	Landing page company description
landing_page_primary_color	string	❌ No	Hex color without # (size 6)
landing_page_secondary_color	string	❌ No	Hex color without # (size 6)

Header Fields

Field	Type	Required	Description
header_title	string	❌ No	Header title
header_subtitle	string	❌ No	Header subtitle
header_description	string	❌ No	Header description
header_registration_link	url	❌ No	Registration link
header_call_to_action_link	url	❌ No	CTA link

Banner Fields

Field	Type	Required	Description
banner_title	string	❌ No	Banner title
banner_call_to_action_link	url	❌ No	Banner CTA link

Footer Fields

Field	Type	Required	Description
footer_address	string	❌ No	Company address
footer_phone_number	string	❌ No	Phone number
footer_mobile_number	string	❌ No	Mobile number
footer_contact_email	email	❌ No	Contact email
footer_google_play	url	❌ No	Google Play link
footer_app_store	url	❌ No	App Store link
footer_download_link	url	❌ No	Download link

Language

Field	Type	Required	Description
language	string	❌ No	2 letters (regex `^[a-zA-Z]{2}$`)

Image Uploads (multipart/form-data)

Field	Type	Required	Description
header_image	file	❌ No	jpg/jpeg/png/svg, max 5MB
header_background_image	file	❌ No	jpg/jpeg/png/svg, max 5MB
banner_image	file	❌ No	jpg/jpeg/png/svg, max 5MB

Response

✅ 200 OK

{ 
    "message": "Landing page updated successfully", 
    "data": 
    { 
        "company_id": 10, 
        "header_title": "Welcome", 
        "banner_title": "New Courses", 
        "header_image_id": 12 
    } 
} 

⚠️ 401 Unauthenticated

{ "message": "Unauthenticated." }

⚠️ 403 Forbidden

{ "message": "No company_id on your user." }

⚠️ 422 Validation Error

{ 
    "message": "Validation error", 
    "errors": 
    { 
        "landing_page_primary_color": ["The landing page primary color must be 6 characters."] 
    } 
} 

❌ 500 Internal Server Error

{ "message": "Error updating landing page: <error details>" }

Sync Trainings (Attach / Reorder)

POST /api/landing-page/trainings/sync Selects and orders trainings displayed on the landing page. Body (Validation Rules)

Introduction

Getting Started

System Design

Modules

API Reference

Development Guide

Deployment

Landing Page

Get Landing Page

Update Landing Page (Create or Update)

Body (Validation Rules)

Sync Trainings (Attach / Reorder)

​Get Landing Page

​Update Landing Page (Create or Update)

​Body (Validation Rules)

​Sync Trainings (Attach / Reorder)

Get Landing Page

Update Landing Page (Create or Update)

Body (Validation Rules)

Sync Trainings (Attach / Reorder)