---
title: "Promote an undeliverable steering message"
method: POST
path: "/api/steering-messages/{id}/undeliverable"
tags: ["Tasks"]
---

# Promote an undeliverable steering message

`POST /api/steering-messages/{id}/undeliverable`

## Path parameters

- `id` string, required

## Request body

- object
  - `reason` string, required

## Response `200`

Steering message promoted to a follow-up task

## Other responses

- `400` — Missing X-Agent-ID header or validation error
- `403` — Steering message task is assigned to another agent
- `404` — Agent or steering message not found

## Changes

- **2026-07-28** `cf533d6b49b0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/steering-messages/:id/undeliverable/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/4f62e32be8ec?raw)