# Change takeover state

{% hint style="warning" %}
All API requests should contain [authorization headers](https://developers.socialboards.com/docs/apis/tickets/authorization-headers).
{% endhint %}

**Request**

```
PATCH chat/conversations/{id}/takeover
```

**Request body**

```json
{
    "assigneeId": null,
    "isAssignedToBot": true
}
```

| Field           | Type          | Comments                                                           |
| --------------- | ------------- | ------------------------------------------------------------------ |
| assigneeId      | nullable guid | Agent unique id assigned to conversation during takeover. Optional |
| isAssignedToBot | boolean       | If `false` starts takeover mode to conversation                    |

**Response**

```json
{
    "data": {
        "isAssignedToBot": true
    },
    "errorCode": -1,
    "errorText": null
}
```

The `Data` field contains an [Conversation takeover](https://developers.socialboards.com/docs/apis/external-chat-api/reference/objects/conversation-takeover) type.
