---
title: "Create Takeover Request"
method: POST
path: "/agent/create-takeover-request/{conversation_id}"
tags: ["Agent User"]
---

# Create Takeover Request

`POST /agent/create-takeover-request/{conversation_id}`

## Path parameters

- `conversation_id` string, uuid, required

## Response `201`

Successful Response

- AgentTakeoverRequest
  - `id` string, uuid
  - `date_created` string, date-time
  - `date_updated` string, date-time
  - `agent_user_id` string, uuid — The ID of the agent user.
  - `conversation_id` string, uuid, required — The ID of the conversation where made request for.
  - `kb_id` string, uuid, required — The ID of the knowledge base.
  - `request_id` integer, required — A unique identifier for the request relative to the knowledge base ID.
  - `is_flagged` boolean — Boolean to indicate if takeover request has been flagged.
  - `category` string, required — The category of this takeover request.
  - `category_id` string, uuid — The ID of the category for this takeover request.
  - `state` string, required — State of this takeover request, could be Taken, Waiting or Resolved.
  - `assigned_to_agent_name` string — Name of the agent which this Agent Takeover request has been assigned to.
  - `flagged_date` string, date-time — Time where takeover request was flagged.
  - `resolved_date` string, date-time — Time where takeover request was resolved.
  - `last_seen_by_user` string, date-time — Time of last seen by user
  - `last_seen_by_agent` string, date-time — Time of last seen by agent

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/dante-ai/apis/dante-ai-api.md) · [All operations](https://skmtc.net/dante-ai/apis/dante-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dante-ai/dante-ai-api/versions/38b6c9a4246d/schema)