> ## Documentation Index
> Fetch the complete documentation index at: https://developer.vanta.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml /reference/manage-vanta.json patch /knowledge-base/resources/webpages/{id}
openapi: 3.0.0
info:
  title: Manage Vanta
  version: 1.0.0
  description: >-
    The REST API lets customers query and mutate Vanta's data. Use this API to
    automate bulk actions, query data for custom workflows and dashboards, and
    bolster your security operations


    **Note for Vanta Gov (FedRAMP) customers:** Select `Vanta Gov (FedRAMP)`
    from the server dropdown to issue requests against
    `https://api.vanta-gov.com`. The OAuth token URL shown below defaults to the
    commercial host — replace it with `https://api.vanta-gov.com/oauth/token`.
  termsOfService: https://www.vanta.com/terms
  license:
    name: UNLICENSED
  contact:
    name: API Support
    url: https://help.vanta.com/
    email: support@vanta.com
servers:
  - url: https://api.vanta.com/v1
    description: Vanta (Commercial)
  - url: https://api.vanta-gov.com/v1
    description: Vanta Gov (FedRAMP)
security: []
paths:
  /knowledge-base/resources/webpages/{id}:
    patch:
      tags:
        - Knowledge Base
      summary: Update webpage resource
      description: |-
        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.
      operationId: UpdateWebpageResource
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWebpageResourceInput'
            example:
              title: Updated security overview
              description: Refreshed copy
              includeSubPages: false
              isUsedInQuestionnaires: true
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeBaseWebpageResourceOutput'
              examples:
                Example 1:
                  value:
                    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
      security:
        - bearerAuth: []
components:
  schemas:
    UpdateWebpageResourceInput:
      properties:
        title:
          type: string
          description: The title of the webpage resource.
          minLength: 1
        description:
          type: string
          nullable: true
          description: A description for the webpage resource. Pass `null` to clear.
        ownerAssignment:
          allOf:
            - $ref: '#/components/schemas/KnowledgeBaseResourceActorAssignmentInput'
          nullable: true
          description: >-
            The actor to assign as owner. Pass `null` to clear. Currently only
            type

            "User" is supported.
        customerVisibility:
          $ref: '#/components/schemas/KnowledgeBaseCustomerVisibility'
          description: Customer visibility on the Trust Center.
        includeSubPages:
          type: boolean
          description: Whether to scan sub-pages one level deep alongside the primary URL.
        isUsedInQuestionnaires:
          type: boolean
          description: |-
            Whether the resource should be used for question-answering in
            Questionnaire Automation.
        expirationDate:
          type: string
          nullable: true
          description: Expiration date in ISO 8601 format. Pass `null` to clear.
        tags:
          items:
            $ref: '#/components/schemas/TagInput'
          type: array
          description: |-
            Tags to associate with the resource. A non-empty array replaces the
            existing tag set; pass `[]` to clear all tags.
        categoryId:
          type: string
          nullable: true
          description: >-
            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.
      type: object
      additionalProperties: false
    KnowledgeBaseWebpageResourceOutput:
      properties:
        id:
          type: string
        type:
          type: string
          enum:
            - URL
          nullable: false
        title:
          type: string
        description:
          type: string
          nullable: true
        url:
          type: string
        customerVisibility:
          type: string
          enum:
            - PRIVATE
            - SHAREABLE
            - REQUEST_ACCESS
            - PUBLIC
            - null
          nullable: true
        includeSubPages:
          type: boolean
          nullable: true
        isUsedInQuestionnaires:
          type: boolean
          nullable: true
        ownerAssignment:
          allOf:
            - $ref: '#/components/schemas/KnowledgeBaseResourceActorAssignment'
          nullable: true
        expirationStatus:
          $ref: '#/components/schemas/KnowledgeBaseExpirationStatus'
        expirationDate:
          type: string
          nullable: true
        lastUpdated:
          type: string
        lastVerified:
          type: string
          nullable: true
        tags:
          items:
            $ref: '#/components/schemas/TagInput'
          type: array
        categoryId:
          type: string
          nullable: true
          description: >-
            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).
      required:
        - id
        - type
        - title
        - description
        - url
        - customerVisibility
        - includeSubPages
        - isUsedInQuestionnaires
        - ownerAssignment
        - expirationStatus
        - expirationDate
        - lastUpdated
        - lastVerified
        - tags
        - categoryId
      type: object
      additionalProperties: false
    KnowledgeBaseResourceActorAssignmentInput:
      properties:
        type:
          type: string
          enum:
            - User
          nullable: false
          description: The type of actor. Currently only "User" is supported.
        id:
          type: string
          description: The unique identifier of the user.
      required:
        - type
        - id
      type: object
      additionalProperties: false
    KnowledgeBaseCustomerVisibility:
      type: string
      enum:
        - PRIVATE
        - SHAREABLE
        - REQUEST_ACCESS
        - PUBLIC
      description: |-
        Customer-facing visibility of a knowledge-base resource on the
        Trust Center. Use {@link CUSTOMER_VISIBILITY_TO_DB} to translate to
        {@link TrustCenterResourceVisibility} when persisting.
    TagInput:
      properties:
        categoryId:
          type: string
        tagId:
          type: string
      required:
        - categoryId
        - tagId
      type: object
      additionalProperties: false
    KnowledgeBaseResourceActorAssignment:
      properties:
        type:
          type: string
          enum:
            - User
            - Team
        id:
          type: string
        displayName:
          type: string
          nullable: true
      required:
        - type
        - id
        - displayName
      type: object
      additionalProperties: false
    KnowledgeBaseExpirationStatus:
      type: string
      enum:
        - CURRENT
        - EXPIRED
      description: |-
        Customer-facing expiration status used by knowledge-base API responses
        (answer library entries and resources). Derived from the persisted
        `expiresAt` field at read time.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````