PATCH
/
api
/
v1
/
accounts
/
{account_id}
/
portals
/
{id}
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

Response

200
application/json

Success

The response is of type object.