---
title: "Update heartbeat"
method: PATCH
path: "/api/{cloudId}/v1/teams/{teamId}/heartbeats"
tags: ["Heartbeats"]
---

# Update heartbeat

`PATCH /api/{cloudId}/v1/teams/{teamId}/heartbeats`

Updates the heartbeat with the given name. Name of a heartbeat cannot be changed

## Path parameters

- `teamId` string, required

## Query parameters

- `name` string, required

## Request body

- UpdateHeartbeatRequest
  - `description` string — An optional description of the heartbe.at
  - `interval` integer — Specifies how often a heartbeat message should be expected.
  - `intervalUnit` 'hours' | 'minutes' | 'days'
  - `enabled` boolean — Enable/disable heartbeat monitoring.
  - `alertMessage` string — Specifies the alert message for heartbeat expiration alert.
  - `alertTags` string[] — Specifies the alert tags for heartbeat expiration alert.
  - `alertPriority` 'P1' | 'P2' | 'P3' | 'P4' | 'P5' — Specifies the alert priority for heartbeat expiration alert.

## Response `201`

Returned if the request is successful.

- Heartbeat
  - `name` string — Name of the heartbeat.
  - `description` string — Description of the heartbeat.
  - `interval` integer — Specifies how often a heartbeat message should be expected.
  - `intervalUnit` 'Days' | 'Minutes' | 'Hours'
  - `enabled` boolean — Enable/disable heartbeat monitoring.
  - `status` 'Unresponsive' | 'Responsive' | 'Off' | 'Pending'
  - `ownerTeamId` string — Owner team of the heartbeat, consisting id of the owner team
  - `alertMessage` string — Specifies the alert message for heartbeat expiration alert.
  - `alertTags` string[] — Specifies the alert tags for heartbeat expiration alert.
  - `alertPriority` 'P1' | 'P2' | 'P3' | 'P4' | 'P5' — Specifies the alert priority for heartbeat expiration alert.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `402` — Returned if the customer subscription plan does not cover heartbeats.
- `403` — Returned if the request user does not have permission to update heartbeat.
- `422` — Returned if the payload cannot be validated.

---

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