Chatous Join Match Queue

PythonSocial Media
POST api.upapi.io/chatous-enqueue.post

Join the Chatous matchmaking queue with your own account so it can be paired with another user. Takes your connect.sid session cookie and optional interest tags. Returns the queue entry id (pass it to chatous-dequeue to leave the queue) and whether an entry was already active. You can be matched with a real person as soon as the call succeeds.

chatousmatchmakingqueue
AuthAPI key
Cost1 unit
Timeout30s
CacheNone

Request schema

FieldTypeDescription
tags
stringInterest tags to match on, in Chatous's own format. Empty matches on nothing in particular.· default: ""
proxyUrl
Optional proxy URL.· default: null
connectSidreq
stringThe account's connect.sid cookie value.

Response schema

FieldTypeDescription
queueIdreq
The queue entry's id. Pass it to chatous-dequeue to release the entry. When alreadyQueued is true this is the id of the entry that BLOCKED this request, which may be a stranded one from an earlier session.
elapsedMsreq
integer
enqueuedAtreq
string
alreadyQueuedreq
booleanTrue when Chatous refused a second entry because one is already active. Not an error: the account is in the queue, just not because of this call.

Try it

Try it

The account's connect.sid cookie value.

Interest tags to match on, in Chatous's own format. Empty matches on nothing in particular.

Optional proxy URL.

Run this endpoint live

Jump in as a guest — no signup — and run chatous-enqueue.post with your own inputs. Create a free account anytime to get your own API key.

Sign in

Code examples

curl -X POST https://api.upapi.io/chatous-enqueue.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "tags": "", "connectSid": "example" }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.