---
title: "Update domain settings"
method: POST
path: "/domains/settings/{domainId}"
tags: ["Domains"]
---

# Update domain settings

`POST /domains/settings/{domainId}`

## Request

- Base URL: `https://api.short.io`
- URL: `https://api.short.io/domains/settings/{domainId}`
- Auth: API key in header `Authorization`

Update domain settings

## Path parameters

- `domainId` integer, required

## Request body

- object
  - `httpsLevel` 'none' | 'redirect' | 'hsts'
  - `robots` 'allow' | 'disallow' | 'noindex'
  - `segmentKey` string, nullable
  - `posthogProjectApiKey` string, nullable
  - `posthogHost` union
    - string: Origin of an official PostHog Cloud instance, e.g. https://eu.i.posthog.com
    - ''
  - `linkType` 'increment' | 'random' | 'secure' | 'four-char' | 'eight-char' | 'ten-char'
  - `cloaking` boolean: Enable cloaking for all links on the domain
  - `hideReferer` boolean
  - `hideVisitorIp` boolean: Don't store visitor IPs in our database
  - `httpsLinks` boolean, nullable: Set to null to reissue a certificate
  - `webhookURL` union
    - string, iri
    - ''
  - `integrationGA` string, nullable
  - `integrationFB` string, nullable
  - `integrationTT` string, nullable
  - `integrationAdroll` string, nullable
  - `enableConversionTracking` boolean
  - `qrScanTracking` boolean
  - `preventScraping` 'none' | 'all': "all" requires every visitor to pass a proof-of-work check before the link resolves. That blocks scrapers, and also link previews, crawlers and any other client that does not run JavaScript.
  - `integrationGTM` string, nullable
  - `clientStorage` object: For internal use
  - `purgeExpiredLinks` boolean: [DEPRECATED] do not use
  - `enableAI` boolean
  - `caseSensitive` boolean: Enable case sensitivity for short links

## Response `200`

Default Response

- object
  - `success` boolean, required: Whether the operation succeeded

## Other responses

- `400`: Default Response
- `401`: Default Response
- `402`: Default Response
- `403`: Default Response
- `404`: Default Response

---

[API](https://skmtc.dev/short/apis/short-io-api-2.md) · [All operations](https://skmtc.dev/short/apis/short-io-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/short/apis/short-io-api-2/revisions/9e4e60c560b1?raw)