GuidesAPI EndpointsKnowledge BaseSupportTalkdesk WebsiteMarketplaceDiscussions API Change LogOpenAPI Specification Download
API Endpoints
Home

Upsert document

put
https://api.talkdeskapp.com/knowledge-management/external-sources//documents/

Inserts a document into the specified external source if it doesn't contain a document with the specified doc_id; updates the specified document otherwise.
Note: This operation is only valid for external sources of type CUSTOM. Attempts to perform it in other types of external sources are rejected with a 400 Bad Request error.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Scope

km-external-sources:write

Path Params
string
required
length between 36 and 36

The external source id.

string
required
length between 1 and 255

The document id.

Body Params

Document to be created or updated.

A document to upsert in an external source.

string
required
length ≥ 1

The URL of the document.

string
required
length ≥ 1

The title of the document.

string
required
length ≥ 1

The content of the document, including HTML tags.

date-time
required
length ≥ 20

The creation date of the document.

date-time
length ≥ 20

The last update date of the document.

metadata
object

The metadata of the document.

Responses
204

Document successfully created/updated.

Updated 2 months ago

Language
Credentials
OAuth2
Missing 1 required scope
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago