---
title: "Update a employee"
method: PUT
path: "/employees/{id_person}/"
tags: ["Employees"]
---

# Update a employee

`PUT /employees/{id_person}/`

## Request

- Base URL: `https://www.pulses.com.br/api/engage/v1`
- URL: `https://www.pulses.com.br/api/engage/v1/employees/{id_person}/`
- Auth: API key in header `Authorization`

When the request for updating employee registration information is sent containing all fields, attention should be paid not to send the 'resignation_date' and 'resignation_reason' fields. These should only be provided in cases of resignation. If they are provided in a case that is not related to resignation, leaving the fields blank will result in an error requesting their completion. The assignment of access profiles (permission_profiles) is not available via API and must be done directly through the platform, on the employee management screen. The access profile (permission_profiles) will only be displayed in the employee query as informational.

## Path parameters

- `id_person` integer, required

## Request body

- Employee
  - `name` string: Employee's name
  - `social_name` string: Employee's Social Name (max length: 250)
  - `birth_name` string: Employee's birth date (YYYY-MM-DD)
  - `email` string: Employee's e-mail
  - `cpf` string: Employee's CPF
  - `internal_number` string: Employee's internal number
  - `cell_phone` string: Employee's cell phone
  - `groups` string: Name or id_group of groups of employee separated by semicolon
  - `leaders` string: Name, CPF, internal_number of leaders of employee separated by semicolon. CPF can be provided with or without punctuation (e.g., 12345678901 or 123.456.789-01).
  - `language` string: pt-BR (default) / en-US / es-ES
  - `blocked` integer: Block employee from receiveing notifications
  - `sex` string: Employee's sex (F/M)
  - `gender` string: Employee's gender (max length: 250)
  - `birthday` string, date: Employee's birth date (YYYY-MM-DD)
  - `hiring_date` string, date: Employee's hiring date (YYYY-MM-DD)
  - `resignation_date` string, date: Employee's resignation date (YYYY-MM-DD)
  - `position` string: Employee's job role
  - `scholarity` string: Employee's scholarity
  - `unit_business` string: Employee's business unit
  - `unit_geography` string: Employee's geographic unit
  - `tags` string[]
  - `custom_attributes` CustomAttributes
    - `attribute_name` string: string

## Response `200`

Successful response

- object
  - `code` integer: Can be 1 for success, otherwise 0 for error
  - `message` string
  - `values` object
    - `id_person` integer

---

[API](https://skmtc.dev/gupy/apis/api-gupy-clima-e-engajamento.md) - [All operations](https://skmtc.dev/gupy/apis/api-gupy-clima-e-engajamento/llms.txt) - [OpenAPI document](https://skmtc.dev/gupy/apis/api-gupy-clima-e-engajamento/revisions/04af6d64e930?raw)