---
title: "Update predefined location"
method: PUT
path: "/configuration/predefined-locations/{id}"
tags: ["predefined-locations"]
---

# Update predefined location

`PUT /configuration/predefined-locations/{id}`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/configuration/predefined-locations/{id}`
- 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`

Updates predefined location by id

## Path parameters

- `id` string, uuid, required

## Request body

- PredefinedLocationRequest
  - `city` string, required: Not blank. No leading and trailing spaces allowed.
  - `countryCode` string, required: ISO-3166-1 alpha-2 country code
  - `region` string
  - `regionAbbr` string: Not blank. No leading and trailing spaces allowed. Region abbreviation, if applicable. E.g. Utah -> UT.
  - `address` string: Not blank. No leading and trailing spaces allowed.
  - `postalCode` string: Not blank. No leading and trailing spaces allowed.
  - `lat` number: Decimal latitude value
  - `lng` number: Decimal longitude value
  - `title` string: User managed Title. If present, value must not be blank and must be unique within the company (case insensitive).
  - `identifier` string: Only alphanumerical characters, dashes, hashes and underscores are allowed. User managed Identifier. If present, value must not be blank and must be unique within the company (case sensitive).

## Response `200`

Predefined location successfully updated

- PredefinedLocation
  - `id` string, uuid
  - `country` string
  - `region` string
  - `regionAbbr` string
  - `countryCode` string
  - `city` string
  - `address` string
  - `postalCode` string
  - `title` string
  - `identifier` string
  - `lat` number
  - `lng` number

## Other responses

- `400`: Invalid request
- `404`: Predefined location not found
- `422`: Cannot update predefined location for the following reason: - TITLE_ALREADY_EXISTS - The title is already used for another predefined location - IDENTIFIER_ALREADY_EXISTS - The identifier is already used for another predefined location

---

[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)