Landing Page

Landing page configuration endpoints: fetch, update (with images), sync trainings/exams positions, manage links, featured categories, and partner companies.

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

✅ 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

✅ 200 OK

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

401

⚠️ 401 Unauthenticated

{ "message": "Unauthenticated." } 

403

⚠️ 403 Forbidden

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

422

⚠️ 422 Validation Error

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

500

❌ 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)