---
title: "Update tenant settings"
method: PUT
path: "/tenants/{slug}"
tags: ["tenants"]
---

# Update tenant settings

`PUT /tenants/{slug}`

## Request

- Base URL: `https://api.animam.ai`
- URL: `https://api.animam.ai/tenants/{slug}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `https://api.animam.ai/oauth/authorize`, token URL `https://api.animam.ai/oauth/token`, scopes: `settings:write`)

Update bot persona, content policy, and integrations. Schema reflects the MCP-shared subset; additional REST-only fields (turnstile, visitor auth, booking CTA, plan limits) accepted but not yet documented here. See https://animam.ai/llms-full.txt for full reference.

## Path parameters

- `slug` string, required: Tenant slug (URL-safe identifier).

## Request body

- UpdateTenantBody
  - `botName` string
  - `botTitle` string
  - `botLore` string
  - `botTone` 'FORMAL' | 'NEUTRAL' | 'FRIENDLY' | 'PLAYFUL' | 'TECHNICAL'
  - `useTutoiement` boolean
  - `allowEmojis` boolean
  - `primaryColor` string
  - `secondaryColor` string, nullable
  - `showAiBadge` boolean
  - `botAvatar` string, uri, nullable
  - `avatarType` 'DEFAULT' | 'UPLOAD' | 'LIBRARY' | 'GENERATED'
  - `teaserText` string, nullable
  - `autoOpen` boolean
  - `autoOpenDelay` integer
  - `bubblePulse` boolean
  - `allowedDomains` string[]
  - `contentPolicy` 'SFW_STRICT' | 'SFW' | 'MODERATE' | 'UNFILTERED'

## Response `200`

Updated tenant.

- object
  - `tenant` object, required
    - `slug` string
    - `name` string
    - `botName` string, nullable
    - `botTitle` string, nullable
    - `botLore` string, nullable
    - `botTone` 'FORMAL' | 'NEUTRAL' | 'FRIENDLY' | 'PLAYFUL' | 'TECHNICAL'
    - `useTutoiement` boolean
    - `allowEmojis` boolean
    - `botAvatar` string, nullable
    - `avatarType` string, nullable
    - `avatarBackground` string, nullable
    - `primaryColor` string
    - `secondaryColor` string, nullable
    - `showAiBadge` boolean
    - `plan` string
    - `conversationsLimit` integer
    - `conversationsUsed` integer
    - `segmentsLimit` integer
    - `corpusLimit` integer
    - `allowedDomains` string[]
    - `contentPolicy` 'SFW_STRICT' | 'SFW' | 'MODERATE' | 'UNFILTERED'
    - `mcpToolsUrl` string, nullable
    - `mcpToolsMaxTools` integer

---

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