---
title: "Deliver a steering message to a running task"
method: POST
path: "/api/tasks/{id}/steer"
tags: ["Tasks"]
---

# Deliver a steering message to a running task

`POST /api/tasks/{id}/steer`

## Path parameters

- `id` string, required

## Request body

- object
  - `message` string, required
  - `mode` 'steer' | 'queue'
  - `onUnsupported` 'degrade' | 'fail'
  - `source` 'ui' | 'mcp' | 'script' | 'slack' | 'api'
  - `requestedByUserId` string

## Response `200`

Steering accepted (see `outcome` for what actually happened)

- SteerResult
  - `outcome` 'steered' | 'queued' | 'promoted', required
  - `steeringMessageId` string, uuid
  - `promotedTaskId` string, uuid
  - `effectiveMode` 'steer' | 'queue', required
  - `degradedFrom` 'steer' | 'queue'

## Other responses

- `400` — Validation error
- `403` — Caller cannot steer this task
- `404` — Task not found
- `422` — Requested mode unsupported by the target harness and onUnsupported=fail

---

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