---
title: "Record a script run heartbeat"
method: POST
path: "/api/internal/script-runs/{runId}/heartbeat"
tags: ["Script Runs"]
---

# Record a script run heartbeat

`POST /api/internal/script-runs/{runId}/heartbeat`

## Path parameters

- `runId` string, uuid, required

## Response `204`

Heartbeat recorded

## Other responses

- `404` — Script run not found

## Changes

- **2026-08-07** `06cac6a7c5bc` — 1 info
  - added the media type `application/json` for the response with the status `404`

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/internal/script-runs/:runId/heartbeat/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/revisions/e0acd2155cad/schema)