Skip to main content
Web CrawlerVersion: v3

Delete trained pages

DEL/knowledge-bases/crawler

Removes trained website pages from a knowledge base so the AI no longer references them. WHEN TO USE: use this when you need to drop specific or all trained URLs; use trainDiscoveredUrls to add pages; use getAllWebsiteUrlsDataByKnowledgeBase to list what is trained. RETURNS: whether the delete succeeded.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:knowledge-bases.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Body

locationIdstringrequired

Location ID as string

Example:qIyivCmsuEOSnyoFYEej
knowledgeBaseIdstring

Knowledge base ID as string (optional)

Example:I1rITlYLJofFosIqC4Np
urlIdsstring[]required

List of URL ids

Example:["689268c7a64d801ef7bb44aa"]
deleteAllbooleanrequired

delete all flag

Example:false
excludeUrlIdsstring[]

URL IDs to exclude from a deleteAll operation (select-all-minus-some flow)

Example:["689268c7a64d801ef7bb44aa"]
searchstring

Substring filter (case-insensitive) matched against url or title to scope deleteAll to filtered rows only. Mirrors the search semantics of the list endpoint.

Example:blog

Response

Selected pages deleted successfully

successbooleanrequired

Indicates if the operation was successful

Example:true
deletedCountnumberrequired

Number of URLs deleted

Example:2
messagestringrequired

Success message

Example:URLs deleted successfully