Get updatable objects
  • 04 Nov 2025
  • 1 Minute to read
  • Contributors

    Get updatable objects


      Article summary

      Get
      /v2.3/objects/updatable-objects

      Retrieves paginated list of network objects that can be used in split tunneling rules. Supports search, filtering, and sorting. Objects represent predefined services and applications. Required permissions: ["updatableObjects:read"]

      Security
      HTTP
      Type bearer
      Query parameters
      name
      string

      Filters the results to include only objects whose name or vendorId matches the specified value. Minimum 1 characters required.

      Min length1
      ExampleAWS Console - HTTPS bypass
      cpId
      string

      Filters the results to include only updatable objects that match the specified Check Point object ID(s). Can be a single ID or an array of IDs divided by commas.

      Min length1
      Example61c6ff56-1431-457b-9c5a-f26398eabc63, a2b5c8f1-3456-789a-bcde-f123456789ab
      page
      integer

      The page number to retrieve from the paginated results.

      Minimum1
      Default1
      Example1
      limit
      integer

      Defines the maximum number of results to return per page in the paginated response. Maximum 1000 documents.

      Minimum1
      Maximum1000
      Default250
      Example500
      sort[name]
      string

      Sorts the results based on name field in ascending or descending order.

      Valid values[ "asc", "desc" ]
      Exampleasc
      Responses
      200

      List of updatable objects

      Expand All
      object
      data
      Array of object (UpdatableObject)
      object
      vendorChildrenIds
      Array of string

      List of child vendor IDs

      string
      cpId
      string

      Check Point object ID (UUID format)

      Pattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      infoText
      string

      Information text about the object

      infoUrl
      string (uri)

      URL with more information about the object

      description
      string

      Description of the updatable object

      name
      string

      Name of the updatable object

      vendorId
      string

      Vendor identifier

      vendorParentId
      string

      Parent vendor identifier

      isRoot
      boolean

      Indicates if this object is a root object

      dataObjectsCount
      integer

      Number of data objects associated with this updatable object

      inheritInfoText
      boolean

      Indicates if the infoText is inherited from the parent object

      inheritInfoUrl
      boolean

      Indicates if the infoUrl is inherited from the parent object

      inheritDescription
      boolean

      Indicates if the description is inherited from the parent object

      page
      integer

      Current page number

      Minimum1
      totalPage
      integer

      Total number of pages

      Minimum1
      itemsTotal
      integer

      Total number of items across all pages

      Minimum0
      itemsPerPage
      integer

      Number of items per page

      Minimum1
      Maximum1000
      400

      Bad Request

      object
      id
      string
      message
      string
      401

      Unauthorized

      object
      id
      string
      message
      string
      403

      Forbidden

      object
      id
      string
      message
      string

      Was this article helpful?