---
title: "Update Session Heartbeat"
method: POST
path: "/dashboards/url/{url}/track-heartbeat"
tags: ["Dashboard"]
---

# Update Session Heartbeat

`POST /dashboards/url/{url}/track-heartbeat`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/dashboards/url/{url}/track-heartbeat`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Update session heartbeat to keep it active for time tracking.

## Path parameters

- `url` string, required

## Request body

- TrackHeartbeatSpec: Session heartbeat tracking parameters
  - `session_id` string, required: Session ID for the dashboard view
  - `page_id` string, nullable: The page the viewer is on (optional)
  - `visible_tiles` string[]: Tile ids at least half in view right now (optional)

## Response `201`

Document created, URL follows

- unknown

## Other responses

- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/17af8131167d?raw)