Admin API

Functions for moderating jobs and managing the platform.

Queries

getPendingJobs

Get all jobs pending review.

const pending = useQuery(api.admin.getPendingJobs);

Authentication: Admin or Moderator role required

Returns: Array of pending job submissions.

getApprovedJobs

Get all approved jobs.

const approvedJobs = useQuery(api.admin.getApprovedJobs);

Authentication: Admin or Moderator role required

Returns: Array of approved jobs.

Mutations

updateJobStatus

Approve or reject a pending job submission.

const updateJobStatus = useMutation(api.admin.updateJobStatus);

await updateJobStatus({ jobId, status: "approved" });

Authentication: Admin or Moderator role required

Parameters:

• jobId - ID of job to update
• status - "approved" or "rejected"

Returns: Confirmation object.

markJobOutdated

Mark an approved job as outdated.

const markJobOutdated = useMutation(api.admin.markJobOutdated);

await markJobOutdated({ jobId });

Authentication: Admin or Moderator role required

Parameters:

• jobId - ID of job to mark outdated

Returns: Confirmation object.

deleteJob

Permanently delete a job.

const deleteJob = useMutation(api.admin.deleteJob);

await deleteJob({ jobId });

Authentication: Admin or Moderator role required

Parameters:

• jobId - ID of job to delete

Returns: Confirmation object.

Deleted jobs are removed from listings; tracked applications remain available in user dashboards as closed entries.