---
title: "Create a new step"
method: POST
path: "/step"
tags: ["step"]
---

# Create a new step

`POST /step`

## Request body

- object
  - `id` string, required
  - `thread_id` string, required
  - `name` string, required
  - `type` string, required
  - `start_time` string, date-time, required
  - `end_time` string, date-time
  - `model_name` string
  - `model_metadata` object
  - `input` string
  - `output` string
  - `input_tokens` number
  - `output_tokens` number

## Response `201`

Step created

- Step
  - `id` string
  - `run_id` string
  - `name` string
  - `type` string
  - `start_time` string, date-time
  - `end_time` string, date-time
  - `model_name` string
  - `model_metadata` object
  - `input_tokens` number
  - `output_tokens` number

---

[API](https://skmtc.net/defra/apis/twiki-api.md) · [All operations](https://skmtc.net/defra/apis/twiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/defra/twiki-api/versions/c3ab20af61ef/schema)