---
title: "Update contact"
method: PUT
path: "/public/v2/contacts/{subjectId}"
tags: ["Contacts"]
---

# Update contact

`PUT /public/v2/contacts/{subjectId}`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/contacts/{subjectId}`
- Auth: HTTP bearer

Required permission: Admin Only - API User Management, Edit.<br/>Update contact on the authenticated account.

## Path parameters

- `subjectId` string, required

## Request body

- UpdateContactOnAccountRequest
  - `roles` string[], nullable: Contact roles on the account.
  - `phoneNumber` string, nullable: Deprecated field: value will be ignored. Contacts update their own phone number.

## Response `200`

Updated contact.

- UserResponseServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` UserResponse
    - `subjectId` string, required: Unique subject ID given to this user.
    - `email` string, required: User email.
    - `roles` string[], required: List of User roles which map to permissions on the specified account.

## Other responses

- `400`: Bad request. Invalid or missing parameter
- `401`: Unauthorized
- `403`: user_lacks_required_permission
- `422`: Failed to update contact.
- `default`: Error

## Changes

- **2026-11-02** `dfd7014cfd6d`: 8 warning, 1 info
  - added the new `2.00` enum value to the `content/requiredPermission/permission` response property for the response status `403`
  - added the new `24.00` enum value to the `content/requiredPermission/featureAccess` response property for the response status `403`
  - added the new `25.00` enum value to the `content/requiredPermission/featureAccess` response property for the response status `403`
  - added the new `3.00` enum value to the `content/requiredPermission/permission` response property for the response status `403`
  - …5 more

[Operation history](https://skmtc.dev/starlink/apis/starlink-management-api/changes/public/v2/contacts/:subjectId/put.md)

---

[API](https://skmtc.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)