---
title: "Heartbeat"
method: POST
path: "/v1/projects/{project_id}/presence/heartbeat"
tags: ["presence"]
---

# Heartbeat

`POST /v1/projects/{project_id}/presence/heartbeat`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/presence/heartbeat`
- Auth: none declared

Announce/refresh that the caller is editing a key (soft-lock + event).
Re-call within ttl_seconds to keep the lock alive.

## Path parameters

- `project_id` string, required

## Request body

- EditingIn
  - `key_uuid` string, required
  - `language_uuid` string, nullable

## Response `200`

Successful Response

- HeartbeatOut
  - `ok` boolean
  - `ttl_seconds` integer, required

## Other responses

- `422`: Validation Error

---

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