---
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

---

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