Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/harshalw2003/BidAuc/llms.txt

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

Seekers use this endpoint to post a new job listing to BidAuc. Once created, the job enters a pending state and becomes immediately visible to Providers browsing available work. Requests must be authenticated and sent as multipart/form-data to support optional image uploads.

​
Request

Method: POST /job/create Authentication: Required (JWT cookie) Content-Type: multipart/form-data

​
Parameters

​
jobName
string
required
The title of the job. This is the primary label displayed to Providers when browsing listings.
​
category
string
required
The service category for the job. Must exactly match one of the 22 valid category names listed below.
​
urgency
string
How urgently the job needs to be completed. Free-form text (for example: "ASAP", "Within a week").
​
description
string
required
A detailed description of the work required.
​
additionalRequirements
string
Any extra requirements or notes for Providers, such as materials to bring or access instructions.
​
jobImages
file
An optional single image illustrating the job (for example, a photo of the area needing repair). Stored as a static asset on the server.

​
Valid category values

The category field must match one of the following names exactly (case-sensitive):
  • Plumbing
  • Electrical Works
  • Carpentry
  • Painting
  • Appliance Repair
  • Residential Cleaning
  • Commercial Cleaning
  • Disinfection Services
  • Pool Cleaning and Maintenance
  • Lawn Care and Mowing
  • Gardening
  • Tree Trimming and Removal
  • Residential Moving
  • Commercial Moving
  • Packing and Unpacking
  • Welding
  • Metal Fabrication
  • Machinery Repair
  • Loading and Unloading
  • Pet Grooming
  • Water Damage Restoration
  • Fire Damage Restoration
If category does not match an existing category name, the job cannot be linked to a valid category. Ensure the value is an exact string match from the list above.

​
Example request

curl --request POST \
  --url https://api.bidauc.com/job/create \
  --cookie "token=<YOUR_JWT_TOKEN>" \
  --form "jobName=Fix kitchen sink leak" \
  --form "category=Plumbing" \
  --form "urgency=ASAP" \
  --form "description=The kitchen sink has a slow leak under the cabinet. Need a licensed plumber to inspect and repair." \
  --form "additionalRequirements=Please bring replacement P-trap parts" \
  --form "jobImages=@/path/to/sink-photo.jpg"

​
Responses

​
200 — success

​
success
boolean
required
Always true on a successful response.
​
message
string
required
Human-readable confirmation message.
{
  "success": true,
  "message": "Job posted successfully!"
}

​
500 — server error

​
success
boolean
required
Always false on an error response.
​
message
string
required
Error description prefixed with "Error posting job: ".
{
  "success": false,
  "message": "Error posting job: Category not found"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us