---
title: "Update a job property value"
method: PATCH
path: "/configuration/job-properties/{id}/values/{valueId}"
tags: ["configuration"]
---

# Update a job property value

`PATCH /configuration/job-properties/{id}/values/{valueId}`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/configuration/job-properties/{id}/values/{valueId}`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `configuration_manage`

Update a job property value. Returns an updated job property value object. Id parameter is a job property id or key.

## Request body

- Path[]
  - `path` string, required

## Response `200`

- JobPropertyValueDefinition
  - `id` string
  - `label` string, required
  - `archived` boolean

## Other responses

- `403`: Forbidden to access the resource, check your authorisation and rights.
- `404`: with codes: * *JOB_PROPERTY_NOT_FOUND* when job property does not exist * *JOB_PROPERTY_VALUE_NOT_FOUND* when job property value does not exist
- `409`: When label being updated conflicts with already existing one.
- `422`: with input validation fails or with codes: * *ACTIVE_VALUES_LIMIT_REACHED* when limit of active job property values is reached. * *JSON_PATCH_INVALID* when patch json is invalid. * *VALUE_LABEL_IS_BLANK* when provided label is blank * *VALUE_LABEL_IS_INVALID* when provided label is not valid, e.g. contains leading/trailing whitespaces

---

[API](https://skmtc.dev/smartrecruiters/apis/configuration-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/configuration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/configuration-api/revisions/65491281a1a6?raw)