---
title: "PATCH /falcon-ai/conversations/{conversation_id}/"
method: PATCH
path: "/falcon-ai/conversations/{conversation_id}/"
tags: ["falcon-ai"]
---

# PATCH /falcon-ai/conversations/{conversation_id}/

`PATCH /falcon-ai/conversations/{conversation_id}/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/falcon-ai/conversations/{conversation_id}/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Get, update, or delete a conversation.

## Request body

- ConversationUpdateRequest
  - `title` string

## Response `200`

OK

- ConversationDetailResponse
  - `status` boolean, required
  - `result` FalconConversationDetail, required
    - `id` string, uuid
    - `user` string, uuid
    - `organization` string, uuid
    - `workspace` string, uuid, nullable
    - `title` string
    - `context_page` string
    - `metadata` object
    - `messages` FalconMessage[]
      - `id` string, uuid
      - `conversation` string, uuid, required
      - `role` 'user' | 'assistant' | 'system', required
      - `content` string
      - `thoughts` object
      - `tool_calls` object
      - `completion_card` object, nullable
      - `files` object
      - `feedback` string
      - `input_tokens` integer
      - `output_tokens` integer
      - `model_used` string
      - `latency_ms` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `403`: Forbidden
- `404`: Not Found
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)