---
title: "Update the profile for a person"
method: PUT
path: "/api/v1/people/{id}"
tags: ["People"]
---

# Update the profile for a person

`PUT /api/v1/people/{id}`

## Path parameters

- `id` string, required

## Request body

- Person
  - `displayName` string
  - `pronouns` string
  - `jobTitle` string
  - `workTeamName` string
  - `workTeamId` string
  - `workLocationName` string
  - `workLocationId` string
  - `workingHours` string
  - `workingTimezone` string
  - `phoneNumber` string
  - `linkedInProfile` string
  - `slackProfileDetails` InternalProfileSlackDetail[]
    - `slackTeamUrl` string
    - `slackTeamName` string
  - `msTeamsProfileUrl` string
  - `manager` Person — recursive
  - `syncedFields` string[]
  - `totalNumDirectReports` integer
  - `synced` boolean
  - `directReports` Person[]
  - `deleted` boolean
  - `startDate` string
  - `userId` string
  - `id` string — The identifier of this User
  - `profilePicUrl` string — The profile picture url for the user
  - `joinedDate` string, date-time
  - `userProfile` UserProfile — Specifies additional information about a Guru User
    - `roleLevel` string — The level at which the user operates in their current role
    - `useCaseList` UseCase[] — Describes different ways the user intends to use Guru
      - `description` string — A description of this use case
    - `role` string — The functional role a Guru user performs on their team
  - `lastName` string, required — The user's last name
  - `firstName` string, required — The user's first name
  - `status` 'ACTIVE' | 'PENDING' — The status of a User can be ACTIVE or PENDING. The User must verify their email address to be considered ACTIVE.
  - `email` string, required — The user's email address
  - `custom` object

## Response `200`

successful operation

- Person
  - `displayName` string
  - `pronouns` string
  - `jobTitle` string
  - `workTeamName` string
  - `workTeamId` string
  - `workLocationName` string
  - `workLocationId` string
  - `workingHours` string
  - `workingTimezone` string
  - `phoneNumber` string
  - `linkedInProfile` string
  - `slackProfileDetails` InternalProfileSlackDetail[]
    - `slackTeamUrl` string
    - `slackTeamName` string
  - `msTeamsProfileUrl` string
  - `manager` Person — recursive
  - `syncedFields` string[]
  - `totalNumDirectReports` integer
  - `synced` boolean
  - `directReports` Person[]
  - `deleted` boolean
  - `startDate` string
  - `userId` string
  - `id` string — The identifier of this User
  - `profilePicUrl` string — The profile picture url for the user
  - `joinedDate` string, date-time
  - `userProfile` UserProfile — Specifies additional information about a Guru User
    - `roleLevel` string — The level at which the user operates in their current role
    - `useCaseList` UseCase[] — Describes different ways the user intends to use Guru
      - `description` string — A description of this use case
    - `role` string — The functional role a Guru user performs on their team
  - `lastName` string, required — The user's last name
  - `firstName` string, required — The user's first name
  - `status` 'ACTIVE' | 'PENDING' — The status of a User can be ACTIVE or PENDING. The User must verify their email address to be considered ACTIVE.
  - `email` string, required — The user's email address
  - `custom` object

## Other responses

- `400` — Invalid/Incomplete Request
- `401` — Request was unauthorized
- `403` — Forbidden access to the resource
- `404` — The person profile doesn't exist

---

[API](https://skmtc.net/getguru/apis/guru-api.md) · [All operations](https://skmtc.net/getguru/apis/guru-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getguru/guru-api/revisions/9090a01dfe1a/schema)