Rename, archive or restore a conversation

PATCH

conversations

{conversation_id}

curl --request PATCH "$MITHUNAI_URL/arukz/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"title": "API key rotation", "archived": true}'

import os, requests

conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
response = requests.patch(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/conversations/{conversation_id}",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={"title": "API key rotation", "archived": True},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/conversations/${conversationId}`,
  {
    method: 'PATCH',
    headers: {
      Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ title: 'API key rotation', archived: true }),
  },
)
console.log(await response.json())

{
  "id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
  "assistant_id": "5b0e2c7a-91d4-4f3e-8a6b-2d7c9e1f4a38",
  "title": "API key rotation",
  "status": "archived",
  "turn_state": "idle",
  "message_count": 2,
  "created_at": "2026-09-24T10:15:02.184311+00:00",
  "updated_at": "2026-09-24T10:31:44.050912+00:00",
  "owner": { "type": "service", "id": "9a7d3e51-2f6c-4b88-a0d4-6e1b5c3f7a92" },
  "metadata": { "source": "support-portal" }
}

{ "code": "validation_error", "message": "The update contained no changes." }

{ "code": "not_found", "message": "The requested resource was not found." }

Only the conversation’s owner can update it. A moderator who can read someone else’s conversation still cannot rename or archive it, and gets 404 as if it did not exist. Send at least one of title, archived or metadata. A field that is absent or null is left unchanged; a body that changes nothing returns 400. The assistant, owner and messages of a conversation cannot be changed. Archiving hides the conversation from List conversations and refuses new questions with 409. Set archived to false to restore it. This request also resolves the conversation’s assistant. If that assistant can no longer answer (it is disabled or archived, or has no knowledge attached), this request returns 400 validation_error.

string

required

The conversation ID.

string

A new title. 1 to 200 characters after trimming, on a single line.

boolean

true to archive the conversation, false to restore it. Must be a JSON boolean.

object

Replaces the conversation’s metadata as a whole; it is not merged. Send {} to clear it. The same limits apply as when you create a conversation: at most 20 entries, keys up to 64 characters matching ^[a-z][a-z0-9_.-]*$, values up to 512 characters on a single line.

Response

Returns 200 OK with the updated conversation.

string

required

The conversation ID.

string

required

The assistant that answers in this conversation.

string

required

The conversation title.

string

required

active or archived.

string

required

idle or awaiting_answer.

integer

required

The number of messages.

string

required

ISO 8601 creation timestamp with a UTC offset.

string

required

ISO 8601 timestamp of this update.

object

required

The owning participant: type is user or service, and id is its identifier.

object

required

Your metadata entries.

curl --request PATCH "$MITHUNAI_URL/arukz/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"title": "API key rotation", "archived": true}'

import os, requests

conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
response = requests.patch(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/conversations/{conversation_id}",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={"title": "API key rotation", "archived": True},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/conversations/${conversationId}`,
  {
    method: 'PATCH',
    headers: {
      Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ title: 'API key rotation', archived: true }),
  },
)
console.log(await response.json())

{
  "id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
  "assistant_id": "5b0e2c7a-91d4-4f3e-8a6b-2d7c9e1f4a38",
  "title": "API key rotation",
  "status": "archived",
  "turn_state": "idle",
  "message_count": 2,
  "created_at": "2026-09-24T10:15:02.184311+00:00",
  "updated_at": "2026-09-24T10:31:44.050912+00:00",
  "owner": { "type": "service", "id": "9a7d3e51-2f6c-4b88-a0d4-6e1b5c3f7a92" },
  "metadata": { "source": "support-portal" }
}

{ "code": "validation_error", "message": "The update contained no changes." }

{ "code": "not_found", "message": "The requested resource was not found." }

Last modified on September 26, 2026

⌘I

curl --request PATCH "$MITHUNAI_URL/arukz/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"title": "API key rotation", "archived": true}'

import os, requests

conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
response = requests.patch(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/conversations/{conversation_id}",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={"title": "API key rotation", "archived": True},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/conversations/${conversationId}`,
  {
    method: 'PATCH',
    headers: {
      Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ title: 'API key rotation', archived: true }),
  },
)
console.log(await response.json())

{
  "id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
  "assistant_id": "5b0e2c7a-91d4-4f3e-8a6b-2d7c9e1f4a38",
  "title": "API key rotation",
  "status": "archived",
  "turn_state": "idle",
  "message_count": 2,
  "created_at": "2026-09-24T10:15:02.184311+00:00",
  "updated_at": "2026-09-24T10:31:44.050912+00:00",
  "owner": { "type": "service", "id": "9a7d3e51-2f6c-4b88-a0d4-6e1b5c3f7a92" },
  "metadata": { "source": "support-portal" }
}

{ "code": "validation_error", "message": "The update contained no changes." }

{ "code": "not_found", "message": "The requested resource was not found." }

Get started

Conversations

Assistants

Models

Knowledge

Widget deployments

Widget (public)

MCP

API keys

Members

Analytics

Support access

Branding

Operations

Rename, archive or restore a conversation

Response

​Response

Response