---
title: "Update Turn"
method: PATCH
path: "/agent-loop/turns/{turn_id}"
tags: ["agent-loop"]
---

# Update Turn

`PATCH /agent-loop/turns/{turn_id}`

Single completion call — updates turn with all results at once.

Dual-auth (see ``require_turn_access``): a per-turn agent-svc JWT bound to
this ``turn_id`` is the agent-service path; Stytch session is the user
path. Both routes resolve to ``actor.user_id`` for cursor advances and
downstream attribution.

## Path parameters

- `turn_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- UpdateTurnRequest
  - `status` string, nullable
  - `assistant_text` string, nullable
  - `tool_calls` unknown
  - `message_deltas` unknown
  - `usage` unknown
  - `error` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.net/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/versions/28bdface01df/schema)