---
title: "Set the purpose of a conversation"
method: POST
path: "/conversations/{convId}/purpose"
tags: ["conversations"]
---

# Set the purpose of a conversation

`POST /conversations/{convId}/purpose`

Updates the purpose (topic or description) of a specific conversation.

**Permission:** `Conversations Write` required.

**Monitoring:** No impact.

## Path parameters

- `convId` integer, required

## Request body

- BodyPurpose
  - `purpose` string

## Response `200`

Conversation purpose successfully updated.

## Other responses

- `400` — Invalid request body or conversation ID.
- `401` — Unauthorized — missing or invalid API token, or missing `Conversations Write` permission.
- `404` — Conversation not found — no conversation matches the provided ID.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)