---
title: "Unpublish a job"
method: POST
path: "/api/v0/jobs/{job_id}/unpublish"
tags: ["Jobs"]
---

# Unpublish a job

`POST /api/v0/jobs/{job_id}/unpublish`

## Request

- Base URL: `https://www.getonbrd.com`
- URL: `https://www.getonbrd.com/api/v0/jobs/{job_id}/unpublish`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/getonbrd/apis/get-on-board-api/docs/api/v0/jobs/:job_id/unpublish/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this for owned live jobs that should stop appearing publicly while staying available for later republishing.

## Path parameters

- `job_id` string, required

## Headers

- `Authorization` string

## Response `200`

Unpublishes an owned live job without hiding it, including board-only live jobs.

- object
  - `data` object, required
    - `id` string, required
    - `type` string, required
    - `attributes` object, required
      - `title` string, required
      - `description_headline` unknown, required
      - `description` string, required
      - `projects` string, required
      - `functions_headline` unknown, required
      - `functions` string, required
      - `benefits_headline` unknown, required
      - `benefits` string, required
      - `desirable_headline` unknown, required
      - `desirable` string, required
      - `remote` boolean, required
      - `remote_modality` string, required
      - `remote_zone` unknown, required
      - `countries` string[], required
      - `lang` string, required
      - `rejected_reasons` object[], required: Job moderation reasons, meaningful when state is rejected or submitted after rejection. Published jobs may retain earlier reasons. Each item has one reason key with localized title and description. Legacy jobs may also contain retired keys: candidate, compensation_missing, other. Consumers should tolerate unknown keys. Private job responses and job.created/job.updated webhooks share this shape.
        - `anonymous_company` object
          - `title` string, required
          - `description` string, required
        - `bad_job` object
          - `title` string, required
          - `description` string, required
        - `contact_info` object
          - `title` string, required
          - `description` string, required
        - `desirable_required` object
          - `title` string, required
          - `description` string, required
        - `duplicate` object
          - `title` string, required
          - `description` string, required
        - `excess_requirements` object
          - `title` string, required
          - `description` string, required
        - `inconsistent_information` object
          - `title` string, required
          - `description` string, required
        - `information` object
          - `title` string, required
          - `description` string, required
        - `insufficient_project_info` object
          - `title` string, required
          - `description` string, required
        - `irrelevant_requirements` object
          - `title` string, required
          - `description` string, required
        - `list_required_as_desirable` object
          - `title` string, required
          - `description` string, required
        - `mismatch_title_description` object
          - `title` string, required
          - `description` string, required
        - `multiple_positions` object
          - `title` string, required
          - `description` string, required
        - `non_compliant_business_practices` object
          - `title` string, required
          - `description` string, required
        - `no_position_info` object
          - `title` string, required
          - `description` string, required
        - `no_requirements` object
          - `title` string, required
          - `description` string, required
        - `not_really_remote` object
          - `title` string, required
          - `description` string, required
        - `obfuscated_company` object
          - `title` string, required
          - `description` string, required
        - `off_topic` object
          - `title` string, required
          - `description` string, required
        - `seniority_mismatch` object
          - `title` string, required
          - `description` string, required
        - `specific_school_required` object
          - `title` string, required
          - `description` string, required
        - `spelling_grammar` object
          - `title` string, required
          - `description` string, required
        - `talent_pool` object
          - `title` string, required
          - `description` string, required
        - `too_vague` object
          - `title` string, required
          - `description` string, required
        - `unclear_functions` object
          - `title` string, required
          - `description` string, required
      - `category_name` string, required
      - `perks` unknown[], required
        - unknown
      - `min_salary` integer, required
      - `max_salary` integer, required
      - `published_at` integer, required
      - `response_time_in_days` object, required
        - `min` unknown, required
        - `max` unknown, required
      - `applications_count` integer, required
      - `location_regions` object, required
        - `data` unknown[], required
          - unknown
      - `location_tenants` object, required
        - `data` unknown[], required
          - unknown
      - `location_cities` object, required
        - `data` object[], required
          - `id` integer, required
          - `type` string, required
      - `modality` object, required
        - `data` object, required
          - `id` integer, required
          - `type` string, required
      - `seniority` object, required
        - `data` object, required
          - `id` integer, required
          - `type` string, required
      - `tags` object, required
        - `data` unknown[], required
          - unknown
      - `state` string, required
      - `company_shell_id` unknown, required
      - `deleted` boolean, required
      - `questions` object, required
        - `data` unknown[], required
          - unknown
      - `location_countries` object, required
        - `data` unknown[], required
          - unknown
      - `submitted_at` integer, required
      - `created_at` integer, required
      - `updated_at` integer, required
      - `hide_salary` boolean
      - `hiring_company` unknown
      - `hiring_company_website` unknown

## Other responses

- `401`: Unpublishes an owned live job without hiding it, including board-only live jobs.
- `404`: Unpublishes an owned live job without hiding it, including board-only live jobs.
- `422`: Unpublishes an owned live job without hiding it, including board-only live jobs.

---

[API](https://skmtc.dev/getonbrd/apis/get-on-board-api.md) - [All operations](https://skmtc.dev/getonbrd/apis/get-on-board-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getonbrd/apis/get-on-board-api/revisions/3d2ce503b070?raw)