---
title: "Update a position (skill)"
method: PATCH
path: "/v1/public/skills/{skillId}"
tags: ["Public", "Skills"]
---

# Update a position (skill)

`PATCH /v1/public/skills/{skillId}`

## Path parameters

- `skillId` string, required

## Request body

- UpdatePublicSkillRequest
  - `names` object — The name of the skill (position) in various locales. Accepted locales are en, fr, es
  - `code` string — A human readable ID that can be use has an ID for other API calls. The code is also used to map a skill to an external system structural element.
  - `abbrev` string — an abbreviation text, used in various place in the application where space is tight. Like on shifts of the schedule view.
  - `externalId` string — A unique UID or a human readable ID that can be use has an ID for other API calls. The externalId can also be used to map a position to an external system structural element.
  - `colorIndex` number — An index from 0 to 19 matching the skill color palette. Check the create position screen in Evolia settings.
  - `enableClocking` boolean — When true, shifts linked to this skill (position) can be clocked in and out by employees.
  - `dontAutoPropagate` boolean — Only relevant for skills with enableClocking set to false. Set this to true to prevent automatic timesheet filling using scheduled hours.
  - `custom` object — To set custom fields to a skill. You can pass a json objet where the values are string. Will merge with previous values.

## Response `200`

- PublicSkill
  - `uid` string, required — unique skill id
  - `status` 'active' | 'deleted', required — Skill status
  - `names` object, required — Multilingual skill name as a map indexed by locale ("en" or "fr")
  - `abbrev` string — Represents the abbreviation of the skill
  - `code` string — The skill code. The code is often used as a mapping value between Evolia and an external system
  - `externalId` string — The skill externalId. The unique externalId is often used as a mapping value between Evolia and an external system
  - `colorIndex` number, required — An index from 0 to 19 matching the skill color palette. Check the create position screen in Evolia settings.
  - `custom` object, nullable — An optional object of custom properties. Current implementation only support string values

---

[API](https://skmtc.dev/evolia/apis/public-evolia.md) · [All operations](https://skmtc.dev/evolia/apis/public-evolia/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolia/public-evolia/revisions/91b80f2b4802/schema)