---
title: "Update posting information"
method: PUT
path: "/publications/{postingId}"
tags: ["feed"]
---

# Update posting information

`PUT /publications/{postingId}`

This endpoint allows updating a single job posting _status_ and _URL_ during a job posting lifecycle.  
You must pass authentication token through **X-SmartToken** HTTP header.

Complete list of body parameters below:

**Status** - This is the posting status on your job board. It should be updated with one of the following values:

*   **Active** - set this status just after you successfully publish a job to your job board; please provide a direct URL to the published job in your job board using _LiveUrl_ so that we can surface it to SmartRecruiters users
*   **UnderPosting** - set this status once you begin the process of posting a job in your job board if your board does not support immediate posting. When posting is complete, update the status to _Active_
*   **Inactive** - set this status once the job is no longer published to your job board
*   **Error** - set this status when an error prevents the job from being published to your job board; please provide error details using the _Comment_ field

**LiveUrl** - This is direct URL to the job you have published in your job board; will be surfaced to SmartRecruiters users  
**Comment** - This is field in which you pass error details when one occurs while publishing a job; error details will be available to our Support Team

## Path parameters

- `postingId` integer, required

## Request body

- PostingUpdateRequest
  - `liveUrl` string
  - `status` string
  - `comment` string

## Response `204`

Posting successfully updated

- string

## Other responses

- `400` — Payload not valid
- `401` — Wrong token
- `404` — PostingId not found

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)