SOCIAL MEDIA

Chatous Leave Match Queue API

Leave the Chatous matchmaking queue by releasing a queue entry id from chatous-enqueue, so your account can queue again. Takes your connect.sid session cookie and the queue id. Returns whether Chatous acknowledged the release and its own return code.

Last updated

chatousmatchmakingqueue
Try it freeGet an API key

How to call it

Send one POST to api.upapi.io/chatous-dequeue.post with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 1 weighted unit of your monthly quota. The operation times out after 30 seconds. Responses are not cached; every call runs the operation.

endpoint
POST https://api.upapi.io/chatous-dequeue.post

Chatous Leave Match Queue API reference

Request parameters

queueId
stringrequired — The queue entry to release, from chatous-enqueue. Required: Chatous rejects an empty body and leaves the entry in place.
proxyUrl
string — Optional proxy URL.
connectSid
stringrequired — The account's connect.sid cookie value.

Response fields

queueId
stringrequired
released
booleanrequired — True when Chatous acknowledged the release.
elapsedMs
integerrequired
releasedAt
stringrequired
returnCode
integerrequired — Chatous's own verdict for the release attempt.

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body
{
  "queueId": "example",
  "connectSid": "example"
}
json — example response shape
{
  "queueId": "example",
  "released": false,
  "elapsedMs": 1,
  "releasedAt": "example",
  "returnCode": 1
}

Code snippets

cURL
curl
curl -X POST https://api.upapi.io/chatous-dequeue.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "queueId": "example", "connectSid": "example" }'
JavaScript
javascript
const response = await fetch('https://api.upapi.io/chatous-dequeue.post', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "queueId": "example",
  "connectSid": "example"
}),
});

const data = await response.json();
console.log(data);
Python
python
import requests

response = requests.post(
    'https://api.upapi.io/chatous-dequeue.post',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "queueId": "example",
  "connectSid": "example"
},
)

print(response.json())
Go
go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "queueId": "example", "connectSid": "example" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/chatous-dequeue.post", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}
PHP
php
<?php

$payload = json_encode([
    'queueId' => 'example',
    'connectSid' => 'example',
]);

$ch = curl_init('https://api.upapi.io/chatous-dequeue.post');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);
Ruby
ruby
require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/chatous-dequeue.post')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "queueId": "example", "connectSid": "example" }.to_json

response = http.request(request)
puts JSON.parse(response.body)
Java
java
import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"queueId\": \"example\", \"connectSid\": \"example\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/chatous-dequeue.post")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}
C#
csharp
using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"queueId\": \"example\", \"connectSid\": \"example\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/chatous-dequeue.post", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Chatous Leave Match Queue 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 Leave Match Queue API?

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

Are Chatous Leave Match Queue API responses cached?

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

More Social Media APIs

Browse every Social Media API →