Update webpage resource

Apply a partial update to a webpage (URL-type) resource. Omitted fields are left untouched. description, ownerAssignment, and expirationDate accept null to clear. The resource URL is not updatable here — recreate the resource if the URL needs to change. Returns 404 for an unknown id or a FILE-type resource.

PATCH /knowledge-base/resources/webpages/{id}

Update webpage resource

cURL

curl --request PATCH \
  --url https://api.vanta.com/v1/knowledge-base/resources/webpages/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Updated security overview",
  "description": "Refreshed copy",
  "includeSubPages": false,
  "isUsedInQuestionnaires": true
}
'

200

{
  "id": "507f1f77bcf86cd799439022",
  "type": "URL",
  "title": "Vanta Security Overview",
  "description": "Public-facing overview of Vanta's security posture.",
  "url": "https://www.vanta.com/security",
  "customerVisibility": "PUBLIC",
  "includeSubPages": true,
  "isUsedInQuestionnaires": true,
  "ownerAssignment": {
    "type": "User",
    "id": "507f1f77bcf86cd799439041",
    "displayName": "Alex Rivera"
  },
  "expirationStatus": "CURRENT",
  "expirationDate": "2025-08-01T00:00:00.000Z",
  "lastUpdated": "2024-11-04T13:21:55.000Z",
  "lastVerified": "2024-11-04T13:21:55.000Z",
  "tags": [
    {
      "categoryId": "507f1f77bcf86cd799439011",
      "tagId": "507f1f77bcf86cd799439014"
    }
  ],
  "categoryId": "507f1f77bcf86cd799439052"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

id · string · required

Body

application/json

title · string

The title of the webpage resource.

Minimum string length: 1

description · string | null

A description for the webpage resource. Pass null to clear.

ownerAssignment · object

The actor to assign as owner. Pass null to clear. Currently only type "User" is supported.

Show child attributes

customerVisibility · enum<string>

Customer visibility on the Trust Center.

Available options: PRIVATE, SHAREABLE, REQUEST_ACCESS, PUBLIC

includeSubPages · boolean

Whether to scan sub-pages one level deep alongside the primary URL.

isUsedInQuestionnaires · boolean

Whether the resource should be used for question-answering in Questionnaire Automation.

expirationDate · string | null

Expiration date in ISO 8601 format. Pass null to clear.

tags · object[]

Tags to associate with the resource. A non-empty array replaces the existing tag set; pass [] to clear all tags.

Show child attributes

categoryId · string | null

Trust Center category id to associate this resource with. Pass null to move the resource to uncategorized. Only valid when the resource's effective visibility (after applying any patched customerVisibility) is REQUEST_ACCESS or PUBLIC; other combinations and unknown ids return an InvalidInputError.

Response

200 - application/json

Ok

id · string · required

type · enum<string> · required

Available options: URL

title · string · required

description · string | null · required

url · string · required

customerVisibility · enum<string> | null · required

Available options: PRIVATE, SHAREABLE, REQUEST_ACCESS, PUBLIC, null

includeSubPages · boolean | null · required

isUsedInQuestionnaires · boolean | null · required

ownerAssignment · object · required

Show child attributes

expirationStatus · enum<string> · required

Customer-facing expiration status used by knowledge-base API responses (answer library entries and resources). Derived from the persisted expiresAt field at read time.

Available options: CURRENT, EXPIRED

expirationDate · string | null · required

lastUpdated · string · required

lastVerified · string | null · required

tags · object[] · required

Show child attributes

categoryId · string | null · required

Trust Center category id the resource is currently filed under, or null if uncategorized (or not on the Trust Center, which is the case for PRIVATE / SHAREABLE resources).