AgentBots
Inbox API
Conversations API
Contact Labels
CSAT Survey Page
Account AgentBots
Agents
Canned Responses
Canned Response
Custom Attributes
Contacts
Automation Rule
Help Center
Conversations
Conversation Assignment
Conversation Labels
Inboxes
Integrations
Profile
Teams
Custom Filters
Help Center
update a new portal
Help Center
update a new portal
update a new portal to account
PATCH
/
api
/
v1
/
accounts
/
{account_id}
/
portals
curl --request PATCH \
--url https://app.chatwoot.com/api/v1/accounts/{account_id}/portals \
--header 'Content-Type: application/json' \
--header 'api_access_token: <api-key>' \
--data '{
"archived": true,
"color": "add color HEX string, \"#fffff\"",
"config": {
"allowed_locales": [
"en",
"es"
],
"default_locale": "en"
},
"custom_domain": "chatwoot.help",
"header_text": "Handbook",
"homepage_link": "https://www.chatwoot.com/",
"name": "<string>",
"slug": "<string>",
"page_title": "<string>",
"account_id": 123
}'
{
"id": 123,
"archived": true,
"color": "<string>",
"config": {},
"custom_domain": "<string>",
"header_text": "<string>",
"homepage_link": "<string>",
"name": "<string>",
"slug": "<string>",
"page_title": "<string>",
"account_id": 123,
"categories": [
{
"id": 123,
"description": "<string>",
"locale": "<string>",
"name": "<string>",
"slug": "<string>",
"position": 123,
"portal_id": 123,
"account_id": 123,
"associated_category_id": 123,
"parent_category_id": 123
}
],
"articles": [
{
"id": 123,
"content": "<string>",
"meta": {},
"position": 123,
"title": "<string>",
"slug": "<string>",
"views": 123,
"portal_id": 123,
"account_id": 123,
"author_id": 123,
"category_id": 123,
"folder_id": 123,
"associated_article_id": 123
}
]
}
Authorizations
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
The numeric ID of the account
Body
application/json
Response
200
application/json
Success
The response is of type object
.
curl --request PATCH \
--url https://app.chatwoot.com/api/v1/accounts/{account_id}/portals \
--header 'Content-Type: application/json' \
--header 'api_access_token: <api-key>' \
--data '{
"archived": true,
"color": "add color HEX string, \"#fffff\"",
"config": {
"allowed_locales": [
"en",
"es"
],
"default_locale": "en"
},
"custom_domain": "chatwoot.help",
"header_text": "Handbook",
"homepage_link": "https://www.chatwoot.com/",
"name": "<string>",
"slug": "<string>",
"page_title": "<string>",
"account_id": 123
}'
{
"id": 123,
"archived": true,
"color": "<string>",
"config": {},
"custom_domain": "<string>",
"header_text": "<string>",
"homepage_link": "<string>",
"name": "<string>",
"slug": "<string>",
"page_title": "<string>",
"account_id": 123,
"categories": [
{
"id": 123,
"description": "<string>",
"locale": "<string>",
"name": "<string>",
"slug": "<string>",
"position": 123,
"portal_id": 123,
"account_id": 123,
"associated_category_id": 123,
"parent_category_id": 123
}
],
"articles": [
{
"id": 123,
"content": "<string>",
"meta": {},
"position": 123,
"title": "<string>",
"slug": "<string>",
"views": 123,
"portal_id": 123,
"account_id": 123,
"author_id": 123,
"category_id": 123,
"folder_id": 123,
"associated_article_id": 123
}
]
}