saved

Get a single saved heatmap by its short_id, including per-width render status.

get/api/projects/{project_id}/saved/{short_id}/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/saved/{short_id}/
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

short_idstring required

Response

idstring uuid required
short_idstring required

Short, URL-safe identifier used as the lookup key for saved-heatmap routes.

namestring nullable

Human-readable label for the saved heatmap.

urlstring uri required

The page URL this saved heatmap renders and overlays data on.

data_urlstring

URL whose heatmap data is overlaid on the screenshot (defaults to 'url').

target_widthsinteger[] required

Viewport widths (CSS pixels) the screenshot is rendered at.

type'screenshot' | 'iframe' | 'recording'
  • screenshot - Screenshot
  • iframe - Iframe
  • recording - Recording
source'server' | 'toolbar' required
  • server - Server
  • toolbar - Toolbar
status'processing' | 'completed' | 'failed' required
  • processing - Processing
  • completed - Completed
  • failed - Failed
has_contentboolean required

Whether at least one rendered image is ready to fetch.

deletedboolean

Soft-delete flag; deleted heatmaps are hidden from the list.

block_consent_modalsboolean

Whether the headless browser dismisses cookie/consent banners before capturing the screenshot. Only applies to 'screenshot' heatmaps.

created_atstring date-time required
updated_atstring date-time required
exceptionstring nullable required

Error detail when screenshot generation failed, otherwise null.

user_access_levelstring nullable required

The effective access level the user has for this object

Changes

No recorded changes to this operation across all 1 revision of this API.