Home
/
REST API Reference
/
AI Content
/
Update a content import source

Update a content import source

You can update an existing content import source.

SecurityHTTP: bearerAuth
Request
path Parameters
id
required
string

The unique identifier for the content import source which is given by Intercom.

header Parameters
Intercom-Version
string (intercom_version)
Default: Unstable

Intercom API version.
By default, it's equal to the version set in the app package.

Enum: "1.0" "1.1" "1.2" "1.3" "1.4" "2.0" "2.1" "2.2" "2.3" "2.4" "2.5" "2.6" "2.7" "2.8" "2.9" "2.10" "2.11" "Unstable"
Example: Unstable
Request Body schema: application/json
sync_behavior
required
string

If you intend to create or update External Pages via the API, this should be set to api. You can not change the value to or from api.

Enum: "api" "automated" "manual"
status
string
Default: "active"

The status of the content import source.

Enum: "active" "deactivated"
url
required
string

The URL of the content import source. This may only be different from the existing value if the sync behavior is API.

put
/ai/content_import_sources/{id}
Request samples
application/json
{
"sync_behavior": "api",
"url": "https://www.example.com"
}
Responses

200

successful

Response Schema: application/json
type
required
string
Default: "content_import_source"

Always external_page

Value: "content_import_source"
id
required
integer

The unique identifier for the content import source which is given by Intercom.

last_synced_at
required
integer <date-time>

The time when the content import source was last synced.

sync_behavior
required
string

If you intend to create or update External Pages via the API, this should be set to api.

Enum: "api" "automatic" "manual"
status
required
string
Default: "active"

The status of the content import source.

Enum: "active" "deactivated"
url
required
string

The URL of the root of the external source.

created_at
required
integer <date-time>

The time when the content import source was created.

updated_at
required
integer <date-time>

The time when the content import source was last updated.

401

Unauthorized

Response samples
application/json
{
"id": 7,
"type": "content_import_source",
"last_synced_at": 1715701756,
"status": "active",
"url": "https://www.example.com",
"sync_behavior": "api",
"created_at": 1715701756,
"updated_at": 1715701756
}