API pipeline: Profile settings
Goal: set your name, interface language, distance units, time format, timezone and the agenda that guides the AI translation of your cards.
Steps
1. Read.
GET /v0/my/self
→ {"nonce": "<you>", "tg_id": "…", "first_name": "Ana", "last_name": "Ruiz", "username": "ana",
"language": "es", "timezone": "Europe/Madrid", "distance_units": "km", "time_format": "24h",
"translation_agenda": "<agenda>"}
2. Change. Send only the fields to change.
PATCH /v0/my/self
{"first_name": "Ana", "language": "en", "distance_units": "mi", "time_format": "12h",
"timezone": "America/Los_Angeles", "translation_agenda": "@my-translator"}
→ the updated profile
Rules
language: the web app offersen,ru,es.distance_units:kmormi.time_format:24hor12h.timezone: an IANA name such asEurope/Berlin.translation_agenda: one of your own agendas, as a nonce or@handle; another one → 404.""clears it.- Names come from Telegram at sign-up; changing them here changes only Cabi.Chat.
API surface
| Endpoint | Purpose | FE | AI / oracle |
|---|---|---|---|
GET /v0/my/self |
Read your profile | yes | yes |
PATCH /v0/my/self |
Change it | yes | yes |
Index: API pipelines — index