The Job Edit API call allows you to edit job ads on HotJobs in real time. Editing a job means either modifying the job ad, taking down a posted job, or posting a not posted job. A valid session token and unique Job ID like the HotJobs Job ID or user-specified Job ID or IO/PO Number are required for editing a job ad. The HotJobs Job ID and other job related details (see response XML below) are returned after a successful job edit.
The following business rules apply for a Job Edit:
Job must be owned by the authenticated user account
Job Status is ‘Not Posted’
All fields may be edited.
Job Status is Posted and ListingType is SLOT
Only the Short Description and Long Description fields may be edited. If any other field is modified, a new job will be created and posted. A copy of the old job, prior to your edits, will be saved in the not posted state. The new job will have a new candidate pool and job stats. If a new job is created, the unique internal ID of the old job and new job, as well as the URL of new job will be returned in the XML response.
Job Status is Posted and ListingType is PAYG (Pay-As-You-Go)
Partner Account - All fields may be updated up to four days from the day the job was posted. After that, only Short Description and Long Description fields may be edited.
Non-Partner Account - only the Short Description and Long Description fields may be edited.
Job Status is Posted and ListingType is POST
Partner Account - All fields may be updated up to four days from the day the job was posted. After that only the Short Description and Long Description fields may be edited.
Non-Partner Account - Only the Short Description and Long Description fields may be edited.
![[Note]](images/docbook/note.png)