---
title: "Deletes a Job posting"
method: DELETE
path: "/api/2026-10-01/resources/ats/job_postings/{id}"
tags: ["Ats > JobPosting"]
---

# Deletes a Job posting

`DELETE /api/2026-10-01/resources/ats/job_postings/{id}`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/ats/job_postings/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `recruitment`
  - API key in header `x-api-key`

Delete a job posting.

## Path parameters

- `id` string, required

## Response `200`

OK

- AtsJobPosting
  - `id` string, required: Unique identifier for the job posting
  - `company_id` string, required: Identifier of the company associated with the job posting
  - `ats_company_id` string, required: Identifier of the ATS company associated with the job posting
  - `title` string, required: Title of the job posting
  - `description` string: Description of the job posting
  - `contract_type` 'indefinite' | 'temporary' | 'intern' | 'training' | 'freelance' | 'vendor_contractor' | 'volunteer' | 'per_hour' | 'other' | 'alternant' | 'interim' | 'minijob' | 'werkstudent' | 'apprenticeship' | 'pj' | 'clt' | 'jovem_aprendiz' | 'a_termo_incerto' | 'a_termo_certo' | 'de_curta_duracao' | 'de_muita_curta_duracao' | 'promessa_de_trabalho' | 'a_tempo_parcial' | 'com_pluralidade_de_empregadores' | 'teletrabalho' | 'pre_reforma' | 'recibos_verdes' | 'estagio' | 'sem_termo' | 'apprentissage' | 'fixed_discontinued' | 'apprendistato'
  - `category` 'administration_and_secretariat' | 'design_and_architecture' | 'education_and_social_policy' | 'engineering' | 'finance' | 'hr' | 'it' | 'legal' | 'management_and_consulting' | 'marketing_and_communication' | 'nursing_and_therapy' | 'physicians' | 'public_sector' | 'purchasing_materials_administration_and_logistics' | 'sales' | 'sciences_and_research' | 'service_industry_and_manufacturing' | 'sports_art_and_creative_jobs' | 'other'
  - `workplace_type` 'onsite' | 'remote' | 'hybrid'
  - `remote` boolean, required: Indicates if the job posting is remote
  - `status` 'draft' | 'published' | 'unlisted' | 'archived' | 'cancelled' | 'deleted', required: The current status of the job posting (e.g., draft, published, archived)
  - `schedule_type` 'full_time' | 'part_time': The schedule type of the job posting (e.g., full_time, part_time)
  - `team_id` string: Identifier of the team associated with the job posting
  - `location_id` string: Identifier of the location associated with the job posting
  - `legal_entity_id` string: Identifier of the legal entity associated with the job posting
  - `salary_format` 'fixed_amount' | 'range': The format of the salary (e.g., range, fixed_amount)
  - `salary_from_amount_in_cents` integer: The minimum salary amount in cents
  - `salary_to_amount_in_cents` integer: The maximum salary amount in cents
  - `hide_salary` boolean: Indicates whether the salary information for the job posting should be hidden from applicants.
  - `cv_requirement` 'mandatory' | 'optional' | 'do_not_ask', required: Requirement for the CV (e.g, mandatory, optional, do_not_ask)
  - `cover_letter_requirement` 'mandatory' | 'optional' | 'do_not_ask', required: Requirement for the cover letter (e.g, mandatory, optional, do_not_ask)
  - `phone_requirement` 'mandatory' | 'optional' | 'do_not_ask', required: Requirement for the phone number (e.g, mandatory, optional, do_not_ask)
  - `photo_requirement` 'mandatory' | 'optional' | 'do_not_ask', required: Requirement for the phone number (e.g, mandatory, optional, do_not_ask)
  - `personal_url_requirement` 'mandatory' | 'optional' | 'do_not_ask', required: Requirement for the personal URL (e.g, mandatory, optional, do_not_ask)
  - `url` string: If published, the public URL of the job posting. Otherwise will be null
  - `salary_period` 'annual' | 'monthly' | 'daily', required: The period of the salary (e.g., annual, monthly, daily)
  - `published_at` string: Published date in ISO 8601 format of the job. If never been published the value will be null
  - `created_at` string, required: Date in ISO 8601 format when the job posting was created

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/ats/job_postings/:id/delete.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)