# Chatous End Chat API

> End a Chatous chat from your own account and optionally block the other person. Takes your connect.sid session cookie, the chat id and a block flag (off by default, and blocking cannot be undone through upAPI). The block is sent only after the disconnect is acknowledged; a rejected disconnect fails the call. Returns the disconnect and block verdicts.

Category: [Social Media APIs](https://upapi.io/apis/social-media) · Last updated 2026-11-07

## How to call it

- Endpoint: `POST https://api.upapi.io/chatous-end-chat.post`, key in the `X-Api-Key` header, JSON body.
- Cost: 1 weighted unit per call.
- Timeout: 30 seconds.
- Cache: none; every call runs the operation.
- Try it without writing code: https://app.upapi.io/try/chatous-end-chat.post

```bash
curl -X POST https://api.upapi.io/chatous-end-chat.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "block": false, "chatId": "example", "connectSid": "example" }'
```

## Request parameters

- `block` (boolean) — Also block the partner. Blocking cannot be undone through upAPI, so it defaults to off. It is only sent after Chatous has acknowledged the disconnect.
- `chatId` (string, required) — The chat to end.
- `proxyUrl` (string) — Optional proxy URL.
- `connectSid` (string, required) — The account's connect.sid cookie value.

## Response fields

- `chatId` (string, required)
- `blocked` (boolean, required) — True when a block was requested and Chatous accepted it.
- `endedAt` (string, required)
- `elapsedMs` (integer, required)
- `blockOutcome` (string, required) — The same two values for the block, or null when none was requested.
- `disconnected` (boolean, required) — Always true on a successful call: the disconnect was acknowledged, or Chatous answered without a code at all, which is normal on this route. A rejected or unreadable answer fails the call instead.
- `blockReturnCode` (integer, required) — Chatous's verdict for the block, or null when no block was requested.
- `disconnectOutcome` (string, required) — acknowledged = return_code 0. no-code-returned = the route answered without one, which it is documented to do. (A non-zero or unreadable code fails the call, so neither appears here.)
- `disconnectReturnCode` (integer, required) — Chatous's verdict for the disconnect, or null when it answered no code.

## Example request and response

The example response is generated from the published output schema: it shows the shape and field names, not values from a recorded call.

```json
{
  "block": false,
  "chatId": "example",
  "connectSid": "example"
}
```

```json
{
  "chatId": "example",
  "blocked": false,
  "endedAt": "example",
  "elapsedMs": 1,
  "blockOutcome": "example",
  "disconnected": false,
  "blockReturnCode": 1,
  "disconnectOutcome": "example",
  "disconnectReturnCode": 1
}
```

## Frequently asked questions

### How much does the Chatous End Chat API cost per call?

Each call spends 1 weighted unit of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

### How do I authenticate to the Chatous End Chat API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

### Are Chatous End Chat API responses cached?

No — every call runs the operation live; responses are not cached.

## More Social Media APIs

- [Chatous Send Message](https://upapi.io/apis/social-media/chatous-send-message)
- [Chatous Get Account State](https://upapi.io/apis/social-media/chatous-get-account-state)
- [Chatous Join Match Queue](https://upapi.io/apis/social-media/chatous-enqueue)
- [Chatous Leave Match Queue](https://upapi.io/apis/social-media/chatous-dequeue)
- [Chatous Login](https://upapi.io/apis/social-media/chatous-login)
- [Chatous Poll Events](https://upapi.io/apis/social-media/chatous-poll-events)
- [Chatous Update Profile](https://upapi.io/apis/social-media/chatous-update-profile)
- [Chatous Upload Profile Photo](https://upapi.io/apis/social-media/chatous-upload-profile-photo)