---
title: "Add a synonym/alias (tenant-scoped or global demo) — E4 compounding thickens search boost + Fact extract. ≤60/hour/key → 429. Idle $0. No invented premiums."
method: GET
path: "/v1/pbx/dictionary/add"
tags: ["PBX Search"]
---

# Add a synonym/alias (tenant-scoped or global demo) — E4 compounding thickens search boost + Fact extract. ≤60/hour/key → 429. Idle $0. No invented premiums.

`GET /v1/pbx/dictionary/add`

## Request

- Base URL: `https://api.temsor.com`
- URL: `https://api.temsor.com/v1/pbx/dictionary/add`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

POST /v1/pbx/dictionary/add {term, alias, domain:hotel|pbx_provider|insurance|finance|energy|automotive, scope?:pbx|global}. Managed SaaS compounding (E4): tenant-scoped aliases thicken search + fact extract. No invented premiums/prices. Idle $0, no LLM. Legacy keys (otel, santral_firmasi, msp…) still accepted.

**Credits per call:** 1 · **Operation id:** `pbx_dictionary_add`

In the GET form every field is a query parameter; object and array fields are JSON-encoded.

## Query parameters

- `term` string, required: Canonical term (e.g. AC, tariff). Plain Turkish preferred.
- `alias` string, required: Synonym / alias to add (e.g. cooling, line package).
- `domain` 'hotel' | 'pbx_provider' | 'insurance' | 'finance' | 'energy' | 'automotive' | 'otel' | 'santral_firmasi' | 'sigorta' | 'finans' | 'enerji' | 'otomotiv' | 'msp': Domain: hotel | pbx_provider | insurance | finance | energy | automotive (legacy keys + msp accepted).
- `kind` 'imei' | 'tarife' | 'oda' | 'oda_tipi' | 'klima' | 'check_out' | 'iade' | 'sku' | 'police' | 'hasar' | 'yenileme' | 'abone' | 'kesinti' | 'fatura' | 'kart' | 'iban' | 'sube' | 'other': Fact kind; inferred from seed term when omitted.
- `boost` number: Search boost weight (default 2).
- `scope` 'pbx' | 'global': pbx = scoped to x-temsor-pbx-key; global = demo-wide. Default: pbx if registered key, else global.
- `hint_tr` string
- `hint_en` string

## Response `200`

Success

- object
  - `ok` unknown, required
  - `data` object, required
    - `applied` boolean, required
    - `entry` object, nullable, required
      - `id` string, required
      - `domain` 'otel' | 'santral_firmasi' | 'sigorta' | 'finans' | 'enerji' | 'otomotiv', required
      - `domain_en` 'hotel' | 'pbx_provider' | 'insurance' | 'finance' | 'energy' | 'automotive'
      - `domain_label_tr` string, required
      - `domain_label_en` string, required
      - `term` string, required
      - `aliases` string[], required
      - `kind` 'imei' | 'tarife' | 'oda' | 'oda_tipi' | 'klima' | 'check_out' | 'iade' | 'sku' | 'police' | 'hasar' | 'yenileme' | 'abone' | 'kesinti' | 'fatura' | 'kart' | 'iban' | 'sube' | 'other', required
      - `boost` number, required
      - `hint_tr` string, required
      - `hint_en` string, required
      - `custom` boolean
    - `alias` object, required
      - `id` string, required
      - `domain` 'otel' | 'santral_firmasi' | 'sigorta' | 'finans' | 'enerji' | 'otomotiv', required
      - `domain_en` 'hotel' | 'pbx_provider' | 'insurance' | 'finance' | 'energy' | 'automotive'
      - `term` string, required
      - `alias` string, required
      - `kind` 'imei' | 'tarife' | 'oda' | 'oda_tipi' | 'klima' | 'check_out' | 'iade' | 'sku' | 'police' | 'hasar' | 'yenileme' | 'abone' | 'kesinti' | 'fatura' | 'kart' | 'iban' | 'sube' | 'other', required
      - `boost` number, required
      - `pbx_id` string, nullable, required
      - `created_at` string, required
      - `hint_tr` string, required
      - `hint_en` string, required
    - `scope` 'pbx' | 'global', required
    - `pbx_id` string, nullable, required
    - `crumbs_preview` object[], required
      - `entry_id` string, required
      - `term` string, required
      - `domain` 'otel' | 'santral_firmasi' | 'sigorta' | 'finans' | 'enerji' | 'otomotiv', required
      - `domain_en` 'hotel' | 'pbx_provider' | 'insurance' | 'finance' | 'energy' | 'automotive'
      - `domain_label_tr` string, required
      - `domain_label_en` string, required
      - `alias_hit` string, required
      - `boost` number, required
    - `note` string, required
    - `note_tr` string, required
  - `meta` object
    - `credits` integer
    - `cached` boolean
    - `requestId` string
    - `durationMs` integer

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Rate limit exceeded — wait `Retry-After` seconds. The RateLimit headers are sent here too.

---

[API](https://skmtc.dev/temsor/apis/temsor-api.md) · [All operations](https://skmtc.dev/temsor/apis/temsor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/temsor/apis/temsor-api/revisions/19702107e15a?raw)