---
title: "Submit Fde Tool Result"
method: POST
path: "/api/v1/fde/conversations/{conversation_id}/tool-result"
tags: ["fde", "fde-messages"]
---

# Submit Fde Tool Result

`POST /api/v1/fde/conversations/{conversation_id}/tool-result`

Submit a tool result for an FDE conversation and resume streaming.

## Path parameters

- `conversation_id` string, uuid, required

## Request body

- FDEToolResultRequest — A tool result plus the model and tool set the resumed turn runs under. The resume is the same turn continuing, so both are replayed from what the turn STARTED with rather than read fresh — the shared chat schema has no field for either, and defaulting here would swap the model mid-turn and silently restore tools the operator had switched off.
  - `tool_call_id` string, required — OpenAI tool_call_id from the AIMessage
  - `tool_name` string, required — Name of the tool (e.g. ask_user)
  - `result` object, required — Structured result, e.g. {"selected_id": "opt1", "selected_label": "Option A"}
  - `model` string, nullable — OpenRouter id of the model to resume on, from GET /fde/models/catalog. Omit to use the configured default.
  - `disabled_tools` string[], nullable — The tool toggles the paused turn STARTED with, replayed by the client for the same reason as `model`: the popover stays live while an ask_user sits pending, so reading it at resume time would finish a turn under a different tool set than it began. Omitting it resumes with every tool enabled.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 18 revisions in range; 1 not diffed.

- **2026-09-08** `0d816626f362` — 1 info
  - added the new optional request property `disabled_tools`
- **2026-09-07** `f074102ed7eb` — 1 info
  - added the new optional request property `model`
- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/fde/conversations/:conversation_id/tool-result/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/202b7d85683e?raw)