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.

Scopes

jobs:write

Create new jobs and update existing jobs, including changing posting status, reposts, and job management. Costs job posting credits for new jobs.

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; free only while the job's original 30-day publication window is still open and subject to the active-job limit; an expired job returns 409 conflict with code JOB_EXPIRED and must be renewed via POST /jobs/repost instead; a job first saved while the brand was not verified returns 403 with code BRAND_VERIFICATION_REQUIRED until the brand is verified), 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.