Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/iDevRanjan/lws-ra-b4-assignment-five/llms.txt

Use this file to discover all available pages before exploring further.

Every application you submit on LWS Job Portal is logged and accessible in one dedicated place. The applications page gives you a complete record of every role you have applied to, the date you applied, and the current status set by the hiring company. You can filter the list to focus on a particular status, sort by date, and withdraw any application at any time with a single click — no need to contact the company directly.

Applications Page

Navigate to /jobseeker-applications to see your full applications history. The page header shows the total number of applications on record (e.g., “12 applications”) and provides filter and sort controls to narrow the list.

Application Card

Each entry in the list is rendered as a card containing:
DetailDescription
Job titleThe name of the role you applied for
Company nameThe organisation that posted the listing
Application dateThe date and time you submitted the application
Status badgeA colour-coded badge showing the current stage of your application
Withdraw buttonA red action button to permanently delete the application

Application Statuses

The status of each application is set and updated by the hiring company from their own dashboard. As a job seeker you can see the current status but cannot change it yourself.
New is the initial status assigned to every application at the moment of submission. It means the company has received your application but has not yet reviewed it. Most applications start here and may stay in this state for several days depending on the volume of applicants.
Status labels are maintained by each company independently. The speed at which a company updates application statuses varies — some update within hours of reviewing, others may take several days.

Filtering Applications by Status

The filter controls at the top of the applications list let you focus on a specific subset of your applications. Select any status to instantly hide everything else:
FilterShows
AllEvery application regardless of status
NewApplications awaiting company review
ShortlistedApplications selected as top candidates
InterviewedApplications that have reached the interview stage
HiredApplications that resulted in a job offer
RejectedApplications that did not progress
Selecting a filter appends a status query parameter to the API request:
GET /api/applications/my-applications?status=Shortlisted
Switching back to All removes the filter and returns the complete list.

Sorting Applications

Use the sort control alongside the status filter to change the order in which your applications are listed.
OptionBehaviour
Newest FirstMost recently submitted applications appear at the top (default)
Oldest FirstEarliest submitted applications appear at the top
Selecting a sort option appends a sort query parameter to the API request:
GET /api/applications/my-applications?sort=Oldest+First
You can combine filtering and sorting at the same time:
GET /api/applications/my-applications?status=New&sort=Oldest+First

Withdrawing an Application

If you change your mind after applying — for example, you accepted another offer or the role is no longer of interest — you can withdraw the application at any time.
1

Find the Application

Open /jobseeker-applications and locate the card for the job you want to withdraw from. Use the status filter if needed to find it faster.
2

Click Withdraw

Click the red Withdraw button on the application card. A browser confirmation dialog appears asking: “Are you sure you want to withdraw this application?”
3

Confirm the Withdrawal

Click OK in the confirmation dialog. The withdrawal request is sent to the API:
DELETE /api/applications/:applicationId
On success, a toast notification confirms the withdrawal and the application is immediately removed from the list. React Query invalidates the applications cache so the count updates without a page refresh.
Withdrawing an application is permanent. The record is deleted from the database and cannot be restored. If you wish to be considered for the same role again, you would need to submit a brand-new application.

Job Seeker Dashboard

The dashboard at /jobseeker-dashboard provides a high-level overview of your job search activity without needing to visit individual pages.

Recent Applications

The Recent Applications widget in the main column shows your most recently submitted applications. It mirrors the same card format as the full applications page, with job title, company, date, and status visible at a glance. A View All link in the widget header takes you directly to /jobseeker-applications. The Recommended for You widget shows jobs personalised to your profile — matching your listed skills and experience level. Recommendations are fetched from:
GET /api/jobs/recommendations
Click any recommended job card to open the full job details page and apply directly.
Applications submitted within 24 hours of a job being posted have a significantly higher response rate. Check the dashboard’s Recommended for You widget regularly to catch new listings early.

Frequently Asked Questions

No. Once you submit an application, the cover letter and attached resume are locked. Applications cannot be edited after submission. If you made a mistake in your cover letter, the only option is to withdraw the application and submit a new one — provided the job listing is still open.
Withdrawing an application sends a DELETE /api/applications/:applicationId request that permanently removes the record from the database. The hiring company will no longer see your application in their applicant list, and the application will disappear from your own applications page immediately. This action cannot be undone.
Statuses are updated exclusively by the hiring company from their recruiter dashboard. When a company shortlists, interviews, hires, or rejects your application, they change the status on their end and the change is reflected immediately on your applications page the next time you load or refresh it. You will not receive an automated email notification — check your applications page regularly to monitor progress.

Search & Apply for Jobs

Find new opportunities and submit your first application.

Profile Management

Keep your profile, resume, and skills up to date to strengthen every application.

Build docs developers (and LLMs) love