Upsert a Document

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.

👍

Access and Registration

Authentication

Scope

km-external-sources:write

Body Response

204 OK - Document successfully created/updated.

401 (unauthorized), 403 (forbidden), 404 (not found), 500 (internal server error)

ParameterTypeDescriptionRequired
codestringn/ayes
messagestringn/ayes
descriptionstringn/ano
fields array[object]"fields" subdivides into:

"name" (string)

"description" (string)
yes (name and description)

🚧

Troubleshooting

If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.

Language
Credentials
Header
Click Try It! to start a request and see the response here!