---
title: "Steer the active turn or send a new turn when idle"
method: POST
path: "/api/v1/sessions/{sessionId}/conversation/steer-or-send"
tags: ["conversations"]
---

# Steer the active turn or send a new turn when idle

`POST /api/v1/sessions/{sessionId}/conversation/steer-or-send`

## Path parameters

- `sessionId` string, required — Session identifier, e.g. project-1.

## Request body

- SteerConversationRequest
  - `attachments` ConversationImageContentRequest[]
    - `data` string, required
    - `mimeType` string, required
  - `clientMessageId` string
  - `recoverOnly` boolean
  - `text` string, required

## Response `202`

Accepted

- SteerOrSendConversationResponse
  - `activityId` string
  - `duplicate` boolean, required
  - `outcome` 'steered' | 'sent', required
  - `providerTurnId` string
  - `state` 'queued' | 'running' | 'completed' | 'recovered' | 'interrupted' | 'failed'
  - `turnId` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error
- `501` — Not Implemented

## Changes

- **2026-09-16** `c248c9b03608` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/sessions/:sessionId/conversation/steer-or-send/post.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/371302977441?raw)