---
title: "Update a person"
method: POST
path: "/apps/{appId}/persons/{id}"
tags: ["Persons"]
---

# Update a person

`POST /apps/{appId}/persons/{id}`

Update a person by id

## Path parameters

- `appId` integer, required
- `id` integer, required

## Query parameters

- `civility` string, nullable
- `lastname` string
- `firstname` string
- `picture` union
  - string, byte
  - string, uri
- `metadata` string[], nullable
- `relationship` object, nullable
- `establishments` object[]
  - `name` string
  - `phones` string[] — Replace all phones
  - `emails` string[] — Replace all emails
  - `phone` string — Add one phone
  - `email` string — Add one email
  - `nic` string — Establishment number (french NIC)
  - `place` object
    - `latitude` integer
    - `longitude` integer
    - `street_number` string
    - `route` string
    - `route2` string
    - `locality` string
    - `sublocality` string
    - `administrative_area_level3` string
    - `administrative_area_level2` string
    - `administrative_area_level1` string
    - `country` string
    - `countryiso2` string
    - `postal_code` string
    - `formatted_address` string — Address formatted for intelligent analysis by google maps
- `establishments` object
  - `name` string
  - `phones` string[] — Replace all phones
  - `emails` string[] — Replace all emails
  - `phone` string — Add one phone
  - `email` string — Add one email
  - `nic` string — Establishment number (french NIC)
  - `place` object
    - `latitude` integer
    - `longitude` integer
    - `street_number` string
    - `route` string
    - `route2` string
    - `locality` string
    - `sublocality` string
    - `administrative_area_level3` string
    - `administrative_area_level2` string
    - `administrative_area_level1` string
    - `country` string
    - `countryiso2` string
    - `postal_code` string
    - `formatted_address` string — Address formatted for intelligent analysis by google maps

## Response `200`

Success

- ContactPerson
  - `id` integer
  - `civility` string, nullable — Civility is the lastname prefix
  - `lastname` string
  - `firstname` string
  - `establishments` EstablishmentIdentity[]
    - `id` integer, nullable — The identifier of the establishment can be absent if the data comes from the INSEE database. In this case, it is not editable
    - `name` string — Establishment name
    - `nic` string, nullable — Establishment number (french NIC)
    - `place` object
      - `id` integer
      - `latitude` integer
      - `longitude` integer
      - `street_number` string
      - `route` string
      - `route2` string
      - `locality` string
      - `sublocality` string
      - `administrative_area_level3` string
      - `administrative_area_level2` string
      - `administrative_area_level1` string
      - `country` string
      - `countryiso2` string
      - `postal_code` string
      - `formatted_address` string — When obtaining data, the formatted address is automatically composed from the other properties of the object. When updating data, the formatted address can be used to automatically hydrate the other properties from Google Maps
    - `emails` string[]
    - `phones` string[]
  - `image` string, uri
  - `metadata` unknown[], nullable
    - unknown

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.net/sinao/apis/sinao-api.md) · [All operations](https://skmtc.net/sinao/apis/sinao-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinao/sinao-api/versions/436b47b78bf4/schema)