Job Edit
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.
URI
http://hj.yahooapis.com/v1/Job/<JobId>
Note
JobId must be a unique job ID, such as HJInternalJobID, or (user
specified) JobID, or IONumber.
HTTP Method
PUT
HTTP Request Body
Job Edit XML Request
HTTP Custom Headers
X-Yahoo-HJAuth-TokenThis is session token returned by Authentication API call.
X-Yahoo-HJAuth-TimestampThis should be the request timestamp in Unix Timestamp format (the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC).
X-Yahoo-HJAuth-SignatureThe signature is MD5 hash of the XML request, request timestamp, job ID (empty for new job), token, and license key, respectively. The signature is also encoded in Hexadecimal format.
Parameters
- Same as Job Post
- To take down a posted job, set Public to False in the Request XML
- To post a not posted/ private job, set Public to True in the Request XML
- To clear the value of any optional fields like Job ID, IO/PO Number, Employer Name, or HiringTes, use a blank value in the request, as is the following example:
Request XML Sample
Same as Job Post Request XML
Success Response XML Sample
The following is an example of a successful response to a Job Edit API call:
Error Response XML Sample
The following is an example of an error response to a Job Edit API call: