---
title: "Retrieve conversation policy"
method: GET
path: "/conversations/{conversationId}/policy"
tags: ["Conversations"]
---

# Retrieve conversation policy

`GET /conversations/{conversationId}/policy`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/conversations/{conversationId}/policy`
- Auth: HTTP bearer

Use to check whether AI responses are paused or human ownership is active before a requested policy change. Use list_conversation_handoffs for why a handoff/review occurred and its saved events. Requires `conversations:read`. Returns current policy status, manual ownership, timed freeze and handoff status. A past or absent freeze timer does not override manual mode, unresolved handoffs, archived or blocked state.

## Path parameters

- `conversationId` string, required

## Response `200`

Success

- ConversationPolicy
  - `conversationId` string
  - `status` 'active' | 'waiting_tool' | 'handoff_requested' | 'closed' | 'archived' | 'blocked'
  - `manualEnabled` boolean
  - `frozenUntilAt` string, date-time, nullable
  - `isFrozen` boolean
  - `frozenSecondsRemaining` integer
  - `conversationKey` string
  - `handoffStatus` 'none' | 'requested' | 'active' | 'resolved'

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)