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

# Create webpage resource

> Create a webpage (URL-type) resource in the Trust Knowledge Base.



## OpenAPI

````yaml /reference/manage-vanta.json post /knowledge-base/resources/webpages
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:
    post:
      tags:
        - Knowledge Base
      summary: Create webpage resource
      description: Create a webpage (URL-type) resource in the Trust Knowledge Base.
      operationId: CreateWebpageResource
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWebpageResourceInput'
            example:
              title: Security overview
              url: https://www.example.com/security
              description: Public security page
              customerVisibility: PUBLIC
              includeSubPages: true
              isUsedInQuestionnaires: true
              tags:
                - categoryId: 507f1f77bcf86cd799439011
                  tagId: 507f1f77bcf86cd799439014
              categoryId: 507f1f77bcf86cd799439052
      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:
    CreateWebpageResourceInput:
      properties:
        title:
          type: string
          description: The title of the webpage resource.
          minLength: 1
        url:
          type: string
          description: The URL of the webpage.
          format: uri
        description:
          type: string
          description: A description for the webpage resource.
        ownerAssignment:
          $ref: '#/components/schemas/KnowledgeBaseResourceActorAssignmentInput'
          description: >-
            The actor to assign as owner. 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
          description: Expiration date in ISO 8601 format.
        tags:
          items:
            $ref: '#/components/schemas/TagInput'
          type: array
          description: Tags to associate with the resource.
        categoryId:
          type: string
          nullable: true
          description: >-
            Trust Center category id to associate this resource with. Pass
            `null`

            to keep the resource uncategorized. Only valid when
            `customerVisibility`

            is REQUEST_ACCESS or PUBLIC; other combinations and unknown ids
            return

            an InvalidInputError.
      required:
        - title
        - url
      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

````