Skip to main content
POST
Update job status

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Path Parameters

id
string
required

The id.

Body

application/json

Change a job's posting status. The job id comes from the path; the MCP tool also sends jobId in the body but the route uses the path id.

action
enum<string>
required

archive (hide but keep data), unarchive (reactivate an archived job; subject to the active-job limit), or delete (permanently remove; refunds 1 credit if the job is under 7 days old).

Available options:
archive,
unarchive,
delete

Response

Result of the archive/unarchive/delete action.

data
object
required

Result of a job status change.