Chatous Update Profile API
Update your Chatous profile: display name, age (18 or older), about text, gender, interest tags and avatar. Takes your connect.sid session cookie. Chatous replaces the whole profile on every write, so any field you omit is cleared. Checks the session first and fails with AUTH_EXPIRED when Chatous no longer accepts it. Returns the list of fields sent.
Last updated
How to call it
Send one POST to api.upapi.io/chatous-update-profile.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.
POST https://api.upapi.io/chatous-update-profile.post
Chatous Update Profile API reference
Request parameters
- age
- integer — Age to publish. Chatous FLOORS this at 18 without saying so, so anything lower is refused here rather than silently changed upstream.
- about
- string — Profile blurb.
- gender
- string — Gender string, sent verbatim.
- proxyUrl
- string — Optional proxy URL.
- avatarIcon
- integer — Chatous avatar icon index.
- connectSid
- stringrequired — The account's connect.sid cookie value.
- screenname
- string — Display name.
- avatarColor
- integer — Chatous avatar colour index.
- profileTags
- array — Interest tags. Sent as a JSON array, as the site expects.
Response fields
- elapsedMs
- integerrequired
- updatedAt
- stringrequired
- ageFloored
- booleanrequired — Always false: an age below 18 is refused before the request is sent.
- updatedFields
- arrayrequired — The form fields actually sent, in sent order.
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.
{
"connectSid": "example"
}{
"elapsedMs": 1,
"updatedAt": "example",
"ageFloored": false,
"updatedFields": [
"example"
]
}Code snippets
cURL
curl -X POST https://api.upapi.io/chatous-update-profile.post \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{ "connectSid": "example" }'JavaScript
const response = await fetch('https://api.upapi.io/chatous-update-profile.post', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY',
},
body: JSON.stringify({
"connectSid": "example"
}),
});
const data = await response.json();
console.log(data);Python
import requests
response = requests.post(
'https://api.upapi.io/chatous-update-profile.post',
headers={
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY',
},
json={
"connectSid": "example"
},
)
print(response.json())Go
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{ "connectSid": "example" }`)
req, _ := http.NewRequest("POST", "https://api.upapi.io/chatous-update-profile.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
$payload = json_encode([
'connectSid' => 'example',
]);
$ch = curl_init('https://api.upapi.io/chatous-update-profile.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
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.upapi.io/chatous-update-profile.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 = { "connectSid": "example" }.to_json
response = http.request(request)
puts JSON.parse(response.body)Java
import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();
String json = "{ \"connectSid\": \"example\" }";
RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
.url("https://api.upapi.io/chatous-update-profile.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#
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>("{ \"connectSid\": \"example\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/chatous-update-profile.post", payload);
var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);Frequently asked questions
How much does the Chatous Update Profile 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 Update Profile API?
Send your key in the X-Api-Key header. A free guest key is available without creating an account.
Are Chatous Update Profile API responses cached?
No — every call runs the operation live; responses are not cached.