---
title: "Update script run status from subprocess"
method: POST
path: "/api/internal/script-runs/{runId}/status"
tags: ["Script Runs"]
---

# Update script run status from subprocess

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

## Path parameters

- `runId` string, uuid, required

## Request body

- union
  - object
    - `status` 'completed', required
    - `output` unknown
  - object
    - `status` 'failed', required
    - `error` string
  - object
    - `status` 'paused', required

## Response `204`

Status updated

## 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/status/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/8cde933218b5/schema)