---
title: "Update Hiring Goal"
method: PUT
path: "/v2/hiring_goals/{id}"
tags: ["Hiring Goals"]
---

# Update Hiring Goal

`PUT /v2/hiring_goals/{id}`

Update an existing Hiring Goal

## Path parameters

- `id` string, required

## Request body

- object
  - `start_date` string — Start date of the Hiring Goal
  - `hire_by` string — The date that the Hiring Goal ends
  - `goal` string — The number of hires needed for this Hiring Goal
  - `opening_id` boolean, nullable — The Opening (also known as Funnel) this Hiring Goal applies to
  - `automatically_close_on_date` string, nullable — The date that the Hiring Goal will automatically close

## Response `202`

Ok

- HiringGoal
  - `automatically_close_on_date` string, nullable — Date that the Hiring Goal will automatically close
  - `closed_at` string, datetime — The date and time at which the hiring goal was closed
  - `created_at` string, datetime — The date and time at which the hiring goal was created
  - `external_id` string — Unique identifier of the Hiring Goal
  - `funnel_id` string — Unique identifier of the associated opening
  - `goal` integer — Number of hires needed for this Hiring Goal
  - `hire_by` string — Date that the Hiring Goal ends
  - `hires_count` integer — Number of hires currently associated with the Hiring Goal
  - `last_updated_at` string, datetime — The date and time at which the hiring goal was last updated
  - `past_due` boolean — Indicates if the hire_by date is in the past
  - `remaining_days` integer — Number of days until this Hiring Goal ends
  - `stage_id` string — Unique identifier of the associated stage
  - `start_date` string — Date that the Hiring Goal begins
  - `status` 'unfilled' | 'filled' — Current status of the Hiring Goal
  - `customer_attributes` CustomerAttribute[], nullable — List of customer attributes for the Hiring Goal
    - `value` string, required — Value of the attribute
    - `type` string, required — Human-readable display name of the attribute
    - `key` string, nullable — Machine-readable identifier for the attribute (e.g. JOB_CODE). Optional — not all endpoints that embed customer_attributes populate this field yet (e.g. openings, locations, and location groups currently return only type and value).

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `501` — NotImplemented

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)