---
title: "PATCH /v4/{+name}"
method: PATCH
path: "/v4/{+name}"
tags: ["projects"]
---

# PATCH /v4/{+name}

`PATCH /v4/{+name}`

Updates the data types for an existing user subscription.

## Path parameters

- `name` string, required

## Query parameters

- `updateMask` string

## Request body

- Subscription — A subscription to a data collection for a specific user, to be delivered to a subscriber.
  - `user` string — Immutable. The resource name of the user for whom this subscription is active. Format: `users/{user}` where `{user}` is the public `healthUserId` as returned by the `GetIdentity` action in the profile PAPI (see `google.devicesandservices.health.v4main.HealthProfileService.GetIdentity`).
  - `name` string — Identifier. The resource name of the Subscription. Format: `projects/{project}/subscribers/{subscriber}/subscriptions/{subscription}` Example: `projects/my-project/subscribers/my-subscriber-123/subscriptions/my-subscription-456` The {project} ID is mandatory (6-30 characters, matching /a-z{6,30}/) The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise. The {subscription} ID is user-settable (4-36 chars, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) or system-generated otherwise.
  - `dataTypes` string[] — Optional. Data types subscribed to. A subscriber will only receive notifications for data types that are declared here. A subscription can only subscribe to the data types of the subscriber. The values should be in the format "users/{health_user_id}/dataTypes/{data_type}" where `{data_type}` is one of "altitude", "distance", "floors", "sleep", "steps", "weight".

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/health.md) · [All operations](https://skmtc.dev/google/apis/health/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/health/revisions/601e805b7a55/schema)