---
title: "Write a script run journal step"
method: POST
path: "/api/internal/script-runs/{runId}/steps"
tags: ["Script Runs"]
---

# Write a script run journal step

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

## Path parameters

- `runId` string, uuid, required

## Request body

- object
  - `stepKey` string, required
  - `stepType` string, required
  - `config` unknown
  - `status` 'completed' | 'failed', required
  - `result` unknown
  - `error` string
  - `durationMs` integer

## Response `201`

Journal step written

- object
  - `ok` true, required

## 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/versions/0375890be8c4/schema)