Skip to main content
PATCH
/
api
/
v1
/
accounts
/
{account_id}
/
portals
/
{id}
Update a portal
curl --request PATCH \
  --url https://app.chatwoot.com/api/v1/accounts/{account_id}/portals/{id} \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '{
  "color": "#FFFFFF",
  "custom_domain": "chatwoot.help",
  "header_text": "Handbook",
  "homepage_link": "https://www.chatwoot.com/",
  "name": "Handbook",
  "page_title": "Handbook",
  "slug": "handbook",
  "archived": false,
  "config": {
    "allowed_locales": [
      "en",
      "es"
    ],
    "default_locale": "en"
  }
}'
{
  "payload": {
    "id": 123,
    "archived": false,
    "color": "#1F93FF",
    "config": {
      "allowed_locales": [
        {
          "code": "en",
          "articles_count": 32,
          "categories_count": 9
        }
      ]
    },
    "custom_domain": "chatwoot.help",
    "header_text": "Handbook",
    "homepage_link": "https://www.chatwoot.com",
    "name": "Handbook",
    "slug": "handbook",
    "page_title": "Handbook",
    "account_id": 123,
    "inbox": {
      "id": 123,
      "name": "Chatwoot",
      "website_url": "chatwoot.com",
      "channel_type": "Channel::WebWidget",
      "avatar_url": "https://example.com/avatar.png",
      "widget_color": "#1F93FF",
      "website_token": "4cWzuf9i9jxN9tbnv8K9STKU",
      "enable_auto_assignment": true,
      "web_widget_script": "<script>...</script>",
      "welcome_title": "Hi there ! 🙌🏼",
      "welcome_tagline": "We make it simple to connect with us.",
      "greeting_enabled": true,
      "greeting_message": "Hey there 👋, Thank you for reaching out to us.",
      "channel_id": 123,
      "working_hours_enabled": true,
      "enable_email_collect": true,
      "csat_survey_enabled": true,
      "timezone": "America/Los_Angeles",
      "business_name": "Chatwoot",
      "hmac_mandatory": true
    },
    "logo": {
      "id": 123,
      "portal_id": 123,
      "file_type": "image/png",
      "account_id": 123,
      "file_url": "https://example.com/logo.png",
      "blob_id": 123,
      "filename": "square.png"
    },
    "meta": {
      "all_articles_count": 32,
      "categories_count": 9,
      "default_locale": "en"
    }
  }
}

Authorizations

​
api_access_token
string
header
required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

​
account_id
integer
required

The numeric ID of the account

​
id
string
required

The slug identifier of the portal

Body

application/json
​
color
string

Header color for help-center in hex format

Example:

"#FFFFFF"

​
custom_domain
string

Custom domain to display help center.

Example:

"chatwoot.help"

​
header_text
string

Help center header

Example:

"Handbook"

​
homepage_link
string

link to main dashboard

Example:

"https://www.chatwoot.com/"

​
name
string

Name for the portal

Example:

"Handbook"

​
page_title
string

Page title for the portal

Example:

"Handbook"

​
slug
string

Slug for the portal to display in link

Example:

"handbook"

​
archived
boolean

Status to check if portal is live

Example:

false

​
config
object

Configuration about supporting locales

Example:
{
  "allowed_locales": ["en", "es"],
  "default_locale": "en"
}

Response

Success

​
payload
object
⌘I