diff --git a/fern/beta/openapi/openapi-beta.yaml b/fern/beta/openapi/openapi-beta.yaml
index 866090bd..92b8c828 100644
--- a/fern/beta/openapi/openapi-beta.yaml
+++ b/fern/beta/openapi/openapi-beta.yaml
@@ -152,7 +152,7 @@ components:
         members:
           description: The users in the conversation.
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -182,7 +182,7 @@ components:
         artifacts:
           description: The IDs of the artifacts to the message.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          - don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           items:
             type: string
           type: array
@@ -284,6 +284,8 @@ components:
         status:
           description: The updated status of the conversation.
           type: string
+        tags:
+          $ref: '#/components/schemas/conversations-update-request-tags'
         title:
           description: The updated title of the conversation.
           type: string
@@ -296,12 +298,21 @@ components:
         set:
           description: Updates the parts that the conversation applies to.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           type: array
       title: conversations-update-request-applies-to-parts
       type: object
+    conversations-update-request-tags:
+      properties:
+        set:
+          description: Sets the tag IDs to the provided tags.
+          items:
+            $ref: '#/components/schemas/set-tag-with-value'
+          type: array
+      title: conversations-update-request-tags
+      type: object
     conversations-update-response:
       description: The response for updating a conversation.
       properties:
@@ -434,66 +445,6 @@ components:
       title: custom-schema-fragments-set-response
       type: object
       x-go-name: CustomSchemaFragmentsSetResponseBody
-    custom-stage:
-      allOf:
-      - $ref: '#/components/schemas/atom-base'
-      title: custom-stage
-    custom-stages-get-response:
-      properties:
-        custom_stage:
-          $ref: '#/components/schemas/custom-stage'
-      required:
-      - custom_stage
-      title: custom-stages-get-response
-      type: object
-      x-go-name: CustomStagesGetResponseBody
-    custom-stages-list-response:
-      properties:
-        cursor:
-          description: |
-            The cursor to resume iteration from, otherwise if not provided,
-            then iteration starts from the beginning.
-          type: string
-        result:
-          description: The custom stages.
-          items:
-            $ref: '#/components/schemas/custom-stage'
-          type: array
-      required:
-      - result
-      title: custom-stages-list-response
-      type: object
-      x-go-name: CustomStagesListResponseBody
-    custom-state:
-      allOf:
-      - $ref: '#/components/schemas/atom-base'
-      title: custom-state
-    custom-states-get-response:
-      properties:
-        custom_state:
-          $ref: '#/components/schemas/custom-state'
-      required:
-      - custom_state
-      title: custom-states-get-response
-      type: object
-      x-go-name: CustomStatesGetResponseBody
-    custom-states-list-response:
-      properties:
-        cursor:
-          description: |
-            The cursor to resume iteration from, otherwise if not provided,
-            then iteration starts from the beginning.
-          type: string
-        result:
-          description: The custom states.
-          items:
-            $ref: '#/components/schemas/custom-state'
-          type: array
-      required:
-      - result
-      title: custom-states-list-response
-      type: object
-      x-go-name: CustomStatesListResponseBody
     dev-user-summary:
       allOf:
       - $ref: '#/components/schemas/user-base-summary'
@@ -828,7 +779,7 @@ components:
       properties:
         rev_org_don:
           description: The don of the rev org to link the rev user to.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
         user_don:
           description: The don of the rev user to link.
@@ -955,6 +906,15 @@ components:
       - after
       - before
       type: string
+    org-base:
+      allOf:
+      - $ref: '#/components/schemas/atom-base'
+      - properties:
+          display_name:
+            description: Name of the Organization.
+            type: string
+        type: object
+      title: org-base
     org-base-summary:
       allOf:
       - $ref: '#/components/schemas/atom-base-summary'
@@ -964,6 +924,14 @@ components:
             type: string
         type: object
       title: org-base-summary
+    org-environment:
+      description: |
+        The environment of the Org. Defaults to 'production' if not specified.
+      enum:
+      - production
+      - staging
+      - test
+      type: string
     org-summary:
       discriminator:
         mapping:
@@ -997,14 +965,186 @@ components:
       allOf:
       - $ref: '#/components/schemas/part-base-summary'
       title: product-summary
+    rev-org:
+      allOf:
+      - $ref: '#/components/schemas/org-base'
+      - properties:
+          custom_schema_fragments:
+            description: Custom schema fragments.
+            example:
+            - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+            items:
+              type: string
+            type: array
+          description:
+            description: Description of the Rev organization.
+            type: string
+          domain:
+            description: Company's domain name. Example - 'devrev.ai'.
+            type: string
+          external_ref:
+            description: |
+              External ref is a unique identifier for the Rev (customer)
+              organization from your primary customer system of records. If none
+              is specified, a system-generated identifier will be assigned to the
+              organization.
+            type: string
+          stock_schema_fragment:
+            description: Stock schema fragment.
+            example: don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+            type: string
+        type: object
+      title: rev-org
     rev-org-summary:
       allOf:
       - $ref: '#/components/schemas/org-base-summary'
       title: rev-org-summary
+    rev-orgs-create-request:
+      description: |
+        Request object to create a new Rev organization in the Dev
+        organization.
+      properties:
+        custom_fields:
+          description: Application-defined custom fields.
+          type: object
+        custom_schema_fragments:
+          description: |
+            Schema fragment IDs associated with this Rev organization.
+          example:
+          - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+          items:
+            type: string
+          type: array
+        description:
+          description: Description of the Rev organization.
+          type: string
+        display_name:
+          description: Name of the Rev organization.
+          type: string
+        domain:
+          description: Company's domain name. Example - 'devrev.ai'.
+          type: string
+        environment:
+          $ref: '#/components/schemas/org-environment'
+        external_ref:
+          description: |
+            External ref is a custom unique identifier which is a reference to
+            an unique id for this organization's data in some system of
+            records.
+          type: string
+        tier:
+          description: The tier of the RevOrg.
+          type: string
+      required:
+      - display_name
+      title: rev-orgs-create-request
+      type: object
+    rev-orgs-create-response:
+      description: |
+        Response object for request to create a new Rev organization.
+      properties:
+        rev_org:
+          $ref: '#/components/schemas/rev-org'
+      required:
+      - rev_org
+      title: rev-orgs-create-response
+      type: object
+      x-go-name: RevOrgsCreateResponseBody
+    rev-orgs-get-response:
+      description: The response to getting a Rev organization's information.
+      properties:
+        rev_org:
+          $ref: '#/components/schemas/rev-org'
+      required:
+      - rev_org
+      title: rev-orgs-get-response
+      type: object
+      x-go-name: RevOrgsGetResponseBody
+    rev-orgs-list-response:
+      description: |
+        The response to getting a list of Rev organizations' information.
+      properties:
+        next_cursor:
+          description: |
+            The cursor used to iterate subsequent results in accordance to the
+            sort order. If not set, then no later elements exist.
+          type: string
+        prev_cursor:
+          description: |
+            The cursor used to iterate preceding results in accordance to the
+            sort order. If not set, then no prior elements exist.
+          type: string
+        rev_orgs:
+          description: List with all of the Rev organizations' information.
+          items:
+            $ref: '#/components/schemas/rev-org'
+          type: array
+      required:
+      - rev_orgs
+      title: rev-orgs-list-response
+      type: object
+      x-go-name: RevOrgsListResponseBody
+    rev-orgs-update-request:
+      description: |
+        Request object to update information of the Rev organization.
+      properties:
+        custom_schema_fragments:
+          description: |
+            Schema fragment IDs associated with this Rev organization.
+          example:
+          - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+          items:
+            type: string
+          type: array
+        description:
+          description: Description of the Rev organization.
+          type: string
+        display_name:
+          description: Customer chosen name for the Rev organization.
+          type: string
+        domain:
+          description: Company's domain name. Example - 'devrev.ai'.
+          type: string
+        environment:
+          $ref: '#/components/schemas/org-environment'
+        external_ref:
+          description: |
+            External ref is a custom unique identifier which is a reference to
+            an unique id for this organization's data in some system of
+            records.
+          type: string
+        id:
+          description: The ID of Rev organization to update.
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
+          type: string
+        tier:
+          description: The tier of the RevOrg.
+          type: string
+      required:
+      - id
+      title: rev-orgs-update-request
+      type: object
+    rev-orgs-update-response:
+      description: Response object to updating Rev organization's information.
+      properties:
+        rev_org:
+          $ref: '#/components/schemas/rev-org'
+      required:
+      - rev_org
+      title: rev-orgs-update-response
+      type: object
+      x-go-name: RevOrgsUpdateResponseBody
     rev-user:
       allOf:
       - $ref: '#/components/schemas/user-base'
       - properties:
+          custom_schema_fragments:
+            description: Custom schema fragments.
+            example:
+            - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+            items:
+              type: string
+            type: array
           description:
             description: Description of the Rev user.
             type: string
@@ -1018,6 +1158,10 @@ components:
             type: string
           rev_org:
             $ref: '#/components/schemas/org-summary'
+          stock_schema_fragment:
+            description: Stock schema fragment.
+            example: don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+            type: string
         type: object
       title: rev-user
     rev-user-summary:
@@ -1040,6 +1184,16 @@ components:
       description: |
         Request object to create a new Rev user for a Rev organization.
       properties:
+        custom_fields:
+          description: Application-defined custom fields.
+          type: object
+        custom_schema_fragments:
+          description: The schema fragment IDs associated with the Rev user.
+          example:
+          - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+          items:
+            type: string
+          type: array
         description:
           description: Description of the Rev user.
           type: string
@@ -1066,7 +1220,7 @@ components:
         rev_org:
           description: |
             The ID of Rev organization for which a Rev user is to be created.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
       required:
       - rev_org
@@ -1135,6 +1289,11 @@ components:
     rev-users-update-request:
       description: Request to update details of a Rev user.
       properties:
+        custom_fields:
+          description: Application-defined custom fields.
+          type: object
+        custom_schema_fragments:
+          $ref: '#/components/schemas/rev-users-update-request-custom-schema-fragments'
         description:
           description: Updated description of the Rev user.
           type: string
@@ -1154,6 +1313,17 @@ components:
       - id
       title: rev-users-update-request
       type: object
+    rev-users-update-request-custom-schema-fragments:
+      properties:
+        set:
+          description: Sets the IDs to the provided schema fragment IDs.
+          example:
+          - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
+          items:
+            type: string
+          type: array
+      title: rev-users-update-request-custom-schema-fragments
+      type: object
     rev-users-update-response:
       description: Updated Rev user object.
       properties:
@@ -1355,7 +1525,7 @@ components:
           description: |
             Whether this field is filterable, groupable and sortable.
           type: boolean
-        is_personally_identifiable_information:
+        is_pii:
           description: |
             Whether this field can hold Personally Identifiable Information
             (PII).
@@ -1369,6 +1539,8 @@ components:
         origin:
           description: Type this field is from.
           type: string
+        ui:
+          $ref: '#/components/schemas/schema-field-ui-metadata'
       required:
       - name
       title: schema-field-descriptor-base
@@ -1387,6 +1559,14 @@ components:
       - timestamp
       - tokens
       type: string
+    schema-field-ui-metadata:
+      description: The schema of ui specific fields.
+      properties:
+        display_name:
+          description: Display name of the field.
+          type: string
+      title: schema-field-ui-metadata
+      type: object
     schema-id-field-descriptor:
       allOf:
       - $ref: '#/components/schemas/schema-field-descriptor-base'
@@ -1701,7 +1881,7 @@ components:
       properties:
         id:
           description: The ID of the tag.
-          example: don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          example: don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           type: string
         value:
           description: |
@@ -1743,36 +1923,6 @@ components:
       description: Override for the allowed values of a stock field enum.
       title: stock-field-enum-override
       type: object
-    stock-schema-fragment:
-      allOf:
-      - $ref: '#/components/schemas/atom-base'
-      title: stock-schema-fragment
-    stock-schema-fragments-get-response:
-      properties:
-        fragment:
-          $ref: '#/components/schemas/stock-schema-fragment'
-      required:
-      - fragment
-      title: stock-schema-fragments-get-response
-      type: object
-      x-go-name: StockSchemaFragmentsGetResponseBody
-    stock-schema-fragments-list-response:
-      properties:
-        cursor:
-          description: |
-            The cursor to resume iteration from, otherwise if not provided,
-            then iteration starts from the beginning.
-          type: string
-        result:
-          description: The stock schema fragments.
-          items:
-            $ref: '#/components/schemas/stock-schema-fragment'
-          type: array
-      required:
-      - result
-      title: stock-schema-fragments-list-response
-      type: object
-      x-go-name: StockSchemaFragmentsListResponseBody
     subtype:
       properties:
         display_name:
@@ -1840,7 +1990,7 @@ components:
           type: string
         display_picture:
           description: Artifact ID of the system user's new display picture.
-          example: don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          example: don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           nullable: true
           type: string
         full_name:
@@ -1898,8 +2048,7 @@ components:
           body_type:
             $ref: '#/components/schemas/timeline-comment-body-type'
           snap_kit_body:
-            description: The SnapKit Body of the comment.
-            type: object
+            $ref: '#/components/schemas/timeline-snap-kit-body'
         type: object
       title: timeline-comment
     timeline-comment-body-type:
@@ -1930,12 +2079,30 @@ components:
       enum:
       - timeline_comment
       type: string
+    timeline-snap-kit-body:
+      description: Snap Kit Body of the comment.
+      properties:
+        body:
+          description: The JSON body of the SnapKit.
+          type: object
+        snap_in_action_name:
+          description: |
+            The name of an action defined in the SnapIn. The combination of
+            snap_in_id and snap_in_action_name uniquely identifies the
+            interaction object which is to be called when actions on a snapkit
+            element is taken.
+          type: string
+        snap_in_id:
+          description: ID of the snap-in which created the SnapKit.
+          type: string
+      title: timeline-snap-kit-body
+      type: object
     unlink-rev-user-from-rev-org-request:
       description: A request to unlink a rev user from a rev org.
       properties:
         rev_org_don:
           description: The don of the rev org to unlink the rev user from.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
         user_don:
           description: The don of the rev user to unlink.
@@ -2132,7 +2299,7 @@ paths:
         name: applies_to_parts
         schema:
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           type: array
@@ -2145,6 +2312,14 @@ paths:
         schema:
           format: int32
           type: integer
+      - description: Filters for conversation that belong to the given groups.
+        explode: false
+        in: query
+        name: group
+        schema:
+          items:
+            type: string
+          type: array
       - description: |
           Filters for conversations where these users are participants.
         explode: false
@@ -2152,7 +2327,7 @@ paths:
         name: members
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -2162,7 +2337,7 @@ paths:
         name: owned_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -2174,7 +2349,7 @@ paths:
         name: rev_org
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          - don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           items:
             type: string
           type: array
@@ -2201,7 +2376,7 @@ paths:
         name: tags
         schema:
           example:
-          - don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          - don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           items:
             type: string
           type: array
@@ -2273,7 +2448,7 @@ paths:
         name: applies_to_parts
         schema:
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           type: array
@@ -2285,6 +2460,14 @@ paths:
         name: cursor
         schema:
           type: string
+      - description: Filters for conversation that belong to the given groups.
+        explode: false
+        in: query
+        name: group
+        schema:
+          items:
+            type: string
+          type: array
       - description: |
           The maximum number of conversations to return. The default is '50'.
         explode: false
@@ -2300,7 +2483,7 @@ paths:
         name: members
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -2318,7 +2501,7 @@ paths:
         name: owned_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -2330,7 +2513,7 @@ paths:
         name: rev_org
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          - don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           items:
             type: string
           type: array
@@ -2357,7 +2540,7 @@ paths:
         name: tags
         schema:
           example:
-          - don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          - don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           items:
             type: string
           type: array
@@ -2599,53 +2782,23 @@ paths:
           $ref: '#/components/responses/service-unavailable'
       tags:
       - links
-  /rev-users.create:
+  /rev-orgs.create:
     post:
       description: |
-        Creates a Rev user for a Rev organization. Rev user can be a customer
-        or a lead of an organization.
-      operationId: rev-users-create
+        Creates a Rev organization in the authenticated user's Dev
+        organization.
+      operationId: rev-orgs-create
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/rev-users-create-request'
+              $ref: '#/components/schemas/rev-orgs-create-request'
       responses:
         "201":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/rev-users-create-response'
-          description: Success.
-        "400":
-          $ref: '#/components/responses/bad-request'
-        "401":
-          $ref: '#/components/responses/unauthorized'
-        "403":
-          $ref: '#/components/responses/forbidden'
-        "429":
-          $ref: '#/components/responses/too-many-requests'
-        "500":
-          $ref: '#/components/responses/internal-server-error'
-        "503":
-          $ref: '#/components/responses/service-unavailable'
-      tags:
-      - rev-users
-  /rev-users.delete:
-    post:
-      description: Deletes a Rev user.
-      operationId: rev-users-delete
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/rev-users-delete-request'
-      responses:
-        "200":
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/rev-users-delete-response'
+                $ref: '#/components/schemas/rev-orgs-create-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -2653,8 +2806,6 @@ paths:
           $ref: '#/components/responses/unauthorized'
         "403":
           $ref: '#/components/responses/forbidden'
-        "404":
-          $ref: '#/components/responses/not-found'
         "429":
           $ref: '#/components/responses/too-many-requests'
         "500":
@@ -2662,25 +2813,26 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - rev-users
-  /rev-users.get:
+      - rev-orgs
+  /rev-orgs.get:
     get:
-      description: Returns the Rev user of a Rev organization by its ID.
-      operationId: rev-users-get
+      description: Retrieves the Rev organization's information.
+      operationId: rev-orgs-get
       parameters:
-      - description: The ID of Rev user to be retrieved.
+      - description: The ID of the required Rev organization.
         explode: false
         in: query
         name: id
         required: true
         schema:
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/rev-users-get-response'
+                $ref: '#/components/schemas/rev-orgs-get-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -2697,48 +2849,16 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - rev-users
-  /rev-users.link:
-    post:
-      description: Links a rev user to a rev org.
-      operationId: link-rev-user-to-rev-org
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/link-rev-user-to-rev-org-request'
-      responses:
-        "200":
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/link-rev-user-to-rev-org-response'
-          description: Success.
-        "400":
-          $ref: '#/components/responses/bad-request'
-        "401":
-          $ref: '#/components/responses/unauthorized'
-        "403":
-          $ref: '#/components/responses/forbidden'
-        "404":
-          $ref: '#/components/responses/not-found'
-        "429":
-          $ref: '#/components/responses/too-many-requests'
-        "500":
-          $ref: '#/components/responses/internal-server-error'
-        "503":
-          $ref: '#/components/responses/service-unavailable'
-      tags:
-      - rev-users
-  /rev-users.list:
+      - rev-orgs
+  /rev-orgs.list:
     get:
       description: |
-        Returns a list of all Rev Users belonging to the authenticated user's
-        Dev Organization.
-      operationId: rev-users-list
+        Gets the list of Rev organizations' information belonging to the
+        authenticated user's Dev Organization which the user is also authorized
+        to access.
+      operationId: rev-orgs-list
       parameters:
-      - description: |
-          Filters for Rev users that were created by the specified user(s).
+      - description: Filters by creator.
         explode: false
         in: query
         name: created_by
@@ -2771,15 +2891,17 @@ paths:
         name: cursor
         schema:
           type: string
-      - description: List of emails of Rev users to be filtered.
+      - description: |
+          Filters on custom fields. Input will be of the format
+          (custom_field_filter=field_name1:val1,val2,val3&custom_field_filter=field_name2:val1,val2).
         explode: false
         in: query
-        name: email
+        name: custom_field_filter
         schema:
           items:
             type: string
           type: array
-      - description: List of external refs to filter Rev users for.
+      - description: List of external refs to filter Rev organizations for.
         explode: false
         in: query
         name: external_ref
@@ -2788,7 +2910,7 @@ paths:
             type: string
           type: array
       - description: |
-          The maximum number of Rev users to return. The default is '50'.
+          The maximum number of Rev organizations to be retrieved per page.
         explode: false
         in: query
         name: limit
@@ -2820,18 +2942,9 @@ paths:
         schema:
           format: date-time
           type: string
-      - description: List of IDs of Rev organizations to be filtered.
-        explode: false
-        in: query
-        name: rev_org
-        schema:
-          example:
-          - don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
-          items:
-            type: string
-          type: array
       - description: |
-          Fields to sort the Rev users by and the direction to sort them.
+          Fields to sort the Rev organizations by and the direction to sort
+          them.
         explode: false
         in: query
         name: sort_by
@@ -2844,7 +2957,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/rev-users-list-response'
+                $ref: '#/components/schemas/rev-orgs-list-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -2861,22 +2974,22 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - rev-users
-  /rev-users.unlink:
+      - rev-orgs
+  /rev-orgs.update:
     post:
-      description: Unlinks a rev user from a rev org.
-      operationId: unlink-rev-user-from-rev-org
+      description: Updates the Rev organization's information.
+      operationId: rev-orgs-update
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/unlink-rev-user-from-rev-org-request'
+              $ref: '#/components/schemas/rev-orgs-update-request'
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/unlink-rev-user-from-rev-org-response'
+                $ref: '#/components/schemas/rev-orgs-update-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -2893,22 +3006,54 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
+      - rev-orgs
+  /rev-users.create:
+    post:
+      description: |
+        Creates a Rev user for a Rev organization. Rev user can be a customer
+        or a lead of an organization.
+      operationId: rev-users-create
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/rev-users-create-request'
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/rev-users-create-response'
+          description: Success.
+        "400":
+          $ref: '#/components/responses/bad-request'
+        "401":
+          $ref: '#/components/responses/unauthorized'
+        "403":
+          $ref: '#/components/responses/forbidden'
+        "429":
+          $ref: '#/components/responses/too-many-requests'
+        "500":
+          $ref: '#/components/responses/internal-server-error'
+        "503":
+          $ref: '#/components/responses/service-unavailable'
+      tags:
       - rev-users
-  /rev-users.update:
+  /rev-users.delete:
     post:
-      description: Updates a Rev user.
-      operationId: rev-users-update
+      description: Deletes a Rev user.
+      operationId: rev-users-delete
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/rev-users-update-request'
+              $ref: '#/components/schemas/rev-users-delete-request'
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/rev-users-update-response'
+                $ref: '#/components/schemas/rev-users-delete-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -2926,25 +3071,15 @@ paths:
           $ref: '#/components/responses/service-unavailable'
       tags:
       - rev-users
-  /schemas.aggregated.get:
+  /rev-users.get:
     get:
-      description: Gets the aggregated schema.
-      operationId: aggregated-schema-get
+      description: Returns the Rev user of a Rev organization by its ID.
+      operationId: rev-users-get
       parameters:
-      - description: |
-          The list of custom schema fragment DONs which are to be aggregated.
-        explode: false
-        in: query
-        name: custom_schema_fragment_ids
-        required: true
-        schema:
-          items:
-            type: string
-          type: array
-      - description: The stock schema fragment which is to be aggregated.
+      - description: The ID of Rev user to be retrieved.
         explode: false
         in: query
-        name: stock_schema_fragment_id
+        name: id
         required: true
         schema:
           type: string
@@ -2953,7 +3088,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/aggregated-schema-get-response'
+                $ref: '#/components/schemas/rev-users-get-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -2970,25 +3105,22 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - customization
-  /schemas.custom.get:
-    get:
-      description: Gets a custom schema fragment.
-      operationId: custom-schema-fragments-get
-      parameters:
-      - description: The ID of the custom schema fragment.
-        explode: false
-        in: query
-        name: id
-        required: true
-        schema:
-          type: string
+      - rev-users
+  /rev-users.link:
+    post:
+      description: Links a rev user to a rev org.
+      operationId: link-rev-user-to-rev-org
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/link-rev-user-to-rev-org-request'
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/custom-schema-fragments-get-response'
+                $ref: '#/components/schemas/link-rev-user-to-rev-org-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3005,37 +3137,66 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - customization
-  /schemas.custom.list:
+      - rev-users
+  /rev-users.list:
     get:
-      description: Lists custom schema fragments.
-      operationId: custom-schema-fragments-list
+      description: |
+        Returns a list of all Rev Users belonging to the authenticated user's
+        Dev Organization.
+      operationId: rev-users-list
       parameters:
-      - description: The list of app names.
+      - description: |
+          Filters for Rev users that were created by the specified user(s).
         explode: false
         in: query
-        name: app
+        name: created_by
         schema:
           items:
             type: string
           type: array
       - description: |
-          The cursor to resume iteration from, otherwise if not provided, then
-          iteration starts from the beginning.
+          Filters for objects created after the provided timestamp (inclusive).
+        explode: false
+        in: query
+        name: created_date.after
+        schema:
+          format: date-time
+          type: string
+      - description: |
+          Filters for objects created before the provided timestamp
+          (inclusive).
+        explode: false
+        in: query
+        name: created_date.before
+        schema:
+          format: date-time
+          type: string
+      - description: |
+          The cursor to resume iteration from. If not provided, then iteration
+          starts from the beginning.
         explode: false
         in: query
         name: cursor
         schema:
           type: string
-      - description: The list of leaf types.
+      - description: List of emails of Rev users to be filtered.
         explode: false
         in: query
-        name: leaf_type
+        name: email
         schema:
           items:
             type: string
           type: array
-      - description: The maximum number of items.
+      - description: List of external refs to filter Rev users for.
+        explode: false
+        in: query
+        name: external_ref
+        schema:
+          items:
+            type: string
+          type: array
+      - description: |
+          The maximum number of Rev users to return. The default is '50'.
         explode: false
         in: query
         name: limit
@@ -3043,36 +3204,55 @@ paths:
           format: int32
           type: integer
       - description: |
-          The list of fields to sort the items by and how to sort them.
+          The iteration mode to use, otherwise if not set, then "after" is
+          used.
         explode: false
         in: query
-        name: sort_by
+        name: mode
         schema:
-          items:
-            type: string
-          type: array
-      - description: The list of subtypes.
+          $ref: '#/components/schemas/list-mode'
+      - description: |
+          Filters for objects created after the provided timestamp (inclusive).
         explode: false
         in: query
-        name: subtype
+        name: modified_date.after
         schema:
+          format: date-time
+          type: string
+      - description: |
+          Filters for objects created before the provided timestamp
+          (inclusive).
+        explode: false
+        in: query
+        name: modified_date.before
+        schema:
+          format: date-time
+          type: string
+      - description: List of IDs of Rev organizations to be filtered.
+        explode: false
+        in: query
+        name: rev_org
+        schema:
+          example:
+          - don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           items:
             type: string
           type: array
-      - description: Filters for custom schema fragment of the provided types.
+      - description: |
+          Fields to sort the Rev users by and the direction to sort them.
         explode: false
         in: query
-        name: types
+        name: sort_by
         schema:
           items:
-            $ref: '#/components/schemas/custom-schema-fragment-type'
+            type: string
           type: array
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/custom-schema-fragments-list-response'
+                $ref: '#/components/schemas/rev-users-list-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3080,6 +3260,8 @@ paths:
           $ref: '#/components/responses/unauthorized'
         "403":
           $ref: '#/components/responses/forbidden'
+        "404":
+          $ref: '#/components/responses/not-found'
         "429":
           $ref: '#/components/responses/too-many-requests'
         "500":
@@ -3087,22 +3269,22 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - customization
-  /schemas.custom.set:
+      - rev-users
+  /rev-users.unlink:
     post:
-      description: Creates or updates a custom schema fragment.
-      operationId: custom-schema-fragments-set
+      description: Unlinks a rev user from a rev org.
+      operationId: unlink-rev-user-from-rev-org
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/custom-schema-fragments-set-request'
+              $ref: '#/components/schemas/unlink-rev-user-from-rev-org-request'
       responses:
-        "201":
+        "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/custom-schema-fragments-set-response'
+                $ref: '#/components/schemas/unlink-rev-user-from-rev-org-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3110,6 +3292,8 @@ paths:
           $ref: '#/components/responses/unauthorized'
         "403":
           $ref: '#/components/responses/forbidden'
+        "404":
+          $ref: '#/components/responses/not-found'
         "429":
           $ref: '#/components/responses/too-many-requests'
         "500":
@@ -3117,30 +3301,22 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - customization
-  /schemas.stock.get:
-    get:
-      description: Gets a stock schema fragment.
-      operationId: stock-schema-fragments-get
-      parameters:
-      - description: The ID of the stock schema fragment.
-        explode: false
-        in: query
-        name: id
-        schema:
-          type: string
-      - description: The leaf type this fragment applies to.
-        explode: false
-        in: query
-        name: leaf_type
-        schema:
-          type: string
+      - rev-users
+  /rev-users.update:
+    post:
+      description: Updates a Rev user.
+      operationId: rev-users-update
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/rev-users-update-request'
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/stock-schema-fragments-get-response'
+                $ref: '#/components/schemas/rev-users-update-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3157,74 +3333,26 @@ paths:
         "503":
           $ref: '#/components/responses/service-unavailable'
       tags:
-      - customization
-  /schemas.stock.list:
+      - rev-users
+  /schemas.aggregated.get:
     get:
-      description: Lists stock schema fragments.
-      operationId: stock-schema-fragments-list
+      description: Gets the aggregated schema.
+      operationId: aggregated-schema-get
       parameters:
       - description: |
-          The cursor to resume iteration from, otherwise if not provided, then
-          iteration starts from the beginning.
-        explode: false
-        in: query
-        name: cursor
-        schema:
-          type: string
-      - description: The list of leaf types.
-        explode: false
-        in: query
-        name: leaf_type
-        schema:
-          items:
-            type: string
-          type: array
-      - description: The maximum number of items.
-        explode: false
-        in: query
-        name: limit
-        schema:
-          format: int32
-          type: integer
-      - description: |
-          The list of fields to sort the items by and how to sort them.
+          The list of custom schema fragment DONs which are to be aggregated.
         explode: false
         in: query
-        name: sort_by
+        name: custom_schema_fragment_ids
+        required: true
         schema:
           items:
             type: string
           type: array
-      responses:
-        "200":
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/stock-schema-fragments-list-response'
-          description: Success.
-        "400":
-          $ref: '#/components/responses/bad-request'
-        "401":
-          $ref: '#/components/responses/unauthorized'
-        "403":
-          $ref: '#/components/responses/forbidden'
-        "429":
-          $ref: '#/components/responses/too-many-requests'
-        "500":
-          $ref: '#/components/responses/internal-server-error'
-        "503":
-          $ref: '#/components/responses/service-unavailable'
-      tags:
-      - customization
-  /schemas.subtypes.list:
-    get:
-      description: Lists subtypes.
-      operationId: subtypes-list
-      parameters:
-      - description: Leaf type for which subtypes are required.
+      - description: The stock schema fragment which is to be aggregated.
         explode: false
         in: query
-        name: leaf_type
+        name: stock_schema_fragment_id
         required: true
         schema:
           type: string
@@ -3233,7 +3361,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/subtypes-list-response'
+                $ref: '#/components/schemas/aggregated-schema-get-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3241,6 +3369,8 @@ paths:
           $ref: '#/components/responses/unauthorized'
         "403":
           $ref: '#/components/responses/forbidden'
+        "404":
+          $ref: '#/components/responses/not-found'
         "429":
           $ref: '#/components/responses/too-many-requests'
         "500":
@@ -3249,12 +3379,12 @@ paths:
           $ref: '#/components/responses/service-unavailable'
       tags:
       - customization
-  /stages.custom.get:
+  /schemas.custom.get:
     get:
-      description: Gets a custom stage.
-      operationId: custom-stages-get
+      description: Gets a custom schema fragment.
+      operationId: custom-schema-fragments-get
       parameters:
-      - description: The ID of the custom stage to get.
+      - description: The ID of the custom schema fragment.
         explode: false
         in: query
         name: id
@@ -3266,7 +3396,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/custom-stages-get-response'
+                $ref: '#/components/schemas/custom-schema-fragments-get-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3284,11 +3414,19 @@ paths:
           $ref: '#/components/responses/service-unavailable'
       tags:
       - customization
-  /stages.custom.list:
+  /schemas.custom.list:
     get:
-      description: Lists custom stages.
-      operationId: custom-stages-list
+      description: Lists custom schema fragments.
+      operationId: custom-schema-fragments-list
       parameters:
+      - description: The list of app names.
+        explode: false
+        in: query
+        name: app
+        schema:
+          items:
+            type: string
+          type: array
       - description: |
           The cursor to resume iteration from, otherwise if not provided, then
           iteration starts from the beginning.
@@ -3297,6 +3435,14 @@ paths:
         name: cursor
         schema:
           type: string
+      - description: The list of leaf types.
+        explode: false
+        in: query
+        name: leaf_type
+        schema:
+          items:
+            type: string
+          type: array
       - description: The maximum number of items.
         explode: false
         in: query
@@ -3304,50 +3450,37 @@ paths:
         schema:
           format: int32
           type: integer
-      - description: ' Required if any marketplace_ref.* fields are provided.'
-        explode: false
-        in: query
-        name: marketplace_ref.id
-        schema:
-          type: string
-      - description: The list of stage names.
+      - description: |
+          The list of fields to sort the items by and how to sort them.
         explode: false
         in: query
-        name: name
+        name: sort_by
         schema:
           items:
             type: string
           type: array
-      - description: The list of stage ordinals.
+      - description: The list of subtypes.
         explode: false
         in: query
-        name: ordinal
+        name: subtype
         schema:
           items:
-            format: int32
-            type: integer
+            type: string
           type: array
-      - description: |
-          The list of fields to sort the items by and how to sort them.
+      - description: Filters for custom schema fragment of the provided types.
         explode: false
         in: query
-        name: sort_by
+        name: types
         schema:
           items:
-            type: string
+            $ref: '#/components/schemas/custom-schema-fragment-type'
           type: array
-      - description: ' Required if any state_id.* fields are provided.'
-        explode: false
-        in: query
-        name: state_id.id
-        schema:
-          type: string
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/custom-stages-list-response'
+                $ref: '#/components/schemas/custom-schema-fragments-list-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3363,24 +3496,21 @@ paths:
           $ref: '#/components/responses/service-unavailable'
       tags:
       - customization
-  /states.custom.get:
-    get:
-      description: Gets a custom state.
-      operationId: custom-states-get
-      parameters:
-      - description: The ID of the custom state to get.
-        explode: false
-        in: query
-        name: id
-        required: true
-        schema:
-          type: string
+  /schemas.custom.set:
+    post:
+      description: Creates or updates a custom schema fragment.
+      operationId: custom-schema-fragments-set
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/custom-schema-fragments-set-request'
       responses:
-        "200":
+        "201":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/custom-states-get-response'
+                $ref: '#/components/schemas/custom-schema-fragments-set-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3388,8 +3518,6 @@ paths:
           $ref: '#/components/responses/unauthorized'
         "403":
           $ref: '#/components/responses/forbidden'
-        "404":
-          $ref: '#/components/responses/not-found'
         "429":
           $ref: '#/components/responses/too-many-requests'
         "500":
@@ -3398,64 +3526,24 @@ paths:
           $ref: '#/components/responses/service-unavailable'
       tags:
       - customization
-  /states.custom.list:
+  /schemas.subtypes.list:
     get:
-      description: Lists custom states.
-      operationId: custom-states-list
+      description: Lists subtypes.
+      operationId: subtypes-list
       parameters:
-      - description: |
-          The cursor to resume iteration from, otherwise if not provided, then
-          iteration starts from the beginning.
+      - description: Leaf type for which subtypes are required.
         explode: false
         in: query
-        name: cursor
+        name: leaf_type
+        required: true
         schema:
           type: string
-      - description: The list of final stage indicators.
-        explode: false
-        in: query
-        name: is_final
-        schema:
-          type: boolean
-      - description: The maximum number of items.
-        explode: false
-        in: query
-        name: limit
-        schema:
-          format: int32
-          type: integer
-      - description: The list of stage names.
-        explode: false
-        in: query
-        name: name
-        schema:
-          items:
-            type: string
-          type: array
-      - description: The list of stage ordinals.
-        explode: false
-        in: query
-        name: ordinal
-        schema:
-          items:
-            format: int32
-            type: integer
-          type: array
-      - description: |
-          The list of fields to sort the items by and how to sort them.
-        explode: false
-        in: query
-        name: sort_by
-        schema:
-          items:
-            type: string
-          type: array
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/custom-states-list-response'
+                $ref: '#/components/schemas/subtypes-list-response'
           description: Success.
         "400":
           $ref: '#/components/responses/bad-request'
@@ -3582,6 +3670,8 @@ tags:
   name: customization
 - description: DevRev link interactions.
   name: links
+- description: Rev organization interactions.
+  name: rev-orgs
 - description: Rev user interactions.
   name: rev-users
 - description: System user interactions
diff --git a/fern/public/openapi/openapi.yaml b/fern/public/openapi/openapi.yaml
index 7e005e64..21280c4f 100644
--- a/fern/public/openapi/openapi.yaml
+++ b/fern/public/openapi/openapi.yaml
@@ -87,7 +87,7 @@ components:
           type: array
         id:
           description: The generated artifact's ID.
-          example: don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          example: don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           type: string
         url:
           description: The URL that the file's data should be uploaded to.
@@ -529,7 +529,7 @@ components:
           type: string
         org_traits:
           $ref: '#/components/schemas/auth-tokens-org-traits'
-        rev_user_id:
+        user_id:
           description: The unique ID of the Rev user.
           type: string
         user_ref:
@@ -537,8 +537,6 @@ components:
           type: string
         user_traits:
           $ref: '#/components/schemas/auth-tokens-user-traits'
-      required:
-      - user_ref
       title: auth-tokens-rev-info
       type: object
     auth-tokens-self-delete-request:
@@ -1087,7 +1085,7 @@ components:
       properties:
         id:
           description: The ID of the part that was deleted.
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
       required:
       - id
@@ -1113,7 +1111,7 @@ components:
       properties:
         id:
           description: The ID of the Rev organization that was deleted.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
       required:
       - id
@@ -1139,7 +1137,7 @@ components:
       properties:
         id:
           description: The ID of the tag that was deleted.
-          example: don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          example: don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           type: string
       required:
       - id
@@ -1165,6 +1163,7 @@ components:
       properties:
         id:
           description: The ID of the timeline entry that was deleted.
+          example: don:core:<partition>:devo/<dev-org-id>:ticket/123:timeline_event/<timeline-event-id>
           type: string
       required:
       - id
@@ -1190,7 +1189,7 @@ components:
       properties:
         id:
           description: The ID of the webhook that was deleted.
-          example: don:<partition>:integration:devo/<dev-org-id>:webhook/<webhook-id>
+          example: don:integration:<partition>:devo/<dev-org-id>:webhook/<webhook-id>
           type: string
       required:
       - id
@@ -1216,7 +1215,7 @@ components:
       properties:
         id:
           description: The ID of the work that was deleted.
-          example: don:<partition>:core:devo/<dev-org-id>:<work-type>/<work-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<work-type>/<work-id>
           type: string
       required:
       - id
@@ -1428,7 +1427,7 @@ components:
         owned_by:
           description: The users that own the part.
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -1445,7 +1444,7 @@ components:
         parent_part:
           description: ID of the parent product for the capability.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           maxItems: 1
@@ -1460,7 +1459,7 @@ components:
           description: |
             ID of the parent part on which the enhancement is to be created.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           maxItems: 1
@@ -1479,7 +1478,7 @@ components:
         parent_part:
           description: ID of the parent capability/feature for the feature.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           maxItems: 1
@@ -1504,7 +1503,7 @@ components:
       properties:
         id:
           description: The ID of the part to delete.
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
       required:
       - id
@@ -1565,7 +1564,7 @@ components:
           type: string
         id:
           description: The ID of the part to update.
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
         name:
           description: The updated name of the part.
@@ -1600,7 +1599,7 @@ components:
             Sets the owner IDs to the provided user IDs. This must not be
             empty.
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -1694,7 +1693,7 @@ components:
       properties:
         id:
           description: The ID of Rev organization to delete.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
       required:
       - id
@@ -1762,7 +1761,7 @@ components:
           type: string
         id:
           description: The ID of Rev organization to update.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
         tier:
           description: The tier of the RevOrg.
@@ -1801,7 +1800,7 @@ components:
       properties:
         id:
           description: The ID of the tag.
-          example: don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          example: don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           type: string
         value:
           description: |
@@ -1931,7 +1930,7 @@ components:
       properties:
         id:
           description: The ID of the tag to delete.
-          example: don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          example: don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           type: string
       required:
       - id
@@ -1995,7 +1994,7 @@ components:
           type: string
         id:
           description: The ID of the tag to update.
-          example: don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          example: don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           type: string
         name:
           description: |
@@ -2053,8 +2052,7 @@ components:
           body_type:
             $ref: '#/components/schemas/timeline-comment-body-type'
           snap_kit_body:
-            description: The SnapKit Body of the comment.
-            type: object
+            $ref: '#/components/schemas/timeline-snap-kit-body'
         type: object
       title: timeline-comment
     timeline-comment-body-type:
@@ -2074,7 +2072,7 @@ components:
       properties:
         object:
           description: The ID of the object to create the timeline entry for.
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
         type:
           $ref: '#/components/schemas/timeline-entries-create-request-type'
@@ -2090,7 +2088,7 @@ components:
         artifacts:
           description: The IDs of the artifacts attached to the comment.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          - don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           items:
             type: string
           type: array
@@ -2100,8 +2098,7 @@ components:
         body_type:
           $ref: '#/components/schemas/timeline-comment-body-type'
         snap_kit_body:
-          description: The SnapKit body of the comment.
-          type: object
+          $ref: '#/components/schemas/timeline-snap-kit-body'
       title: timeline-entries-create-request-timeline-comment
       type: object
     timeline-entries-create-request-type:
@@ -2162,6 +2159,7 @@ components:
       properties:
         id:
           description: The ID of the timeline entry to update.
+          example: don:core:<partition>:devo/<dev-org-id>:ticket/123:timeline_event/<timeline-event-id>
           type: string
         type:
           $ref: '#/components/schemas/timeline-entries-update-request-type'
@@ -2180,8 +2178,7 @@ components:
         body_type:
           $ref: '#/components/schemas/timeline-comment-body-type'
         snap_kit_body:
-          description: The SnapKit body of the comment.
-          type: object
+          $ref: '#/components/schemas/timeline-snap-kit-body'
       title: timeline-entries-update-request-timeline-comment
       type: object
     timeline-entries-update-request-timeline-comment-artifacts:
@@ -2192,7 +2189,7 @@ components:
             added more than once, i.e. nothing is done if the artifact is
             already attached. Mutually exclusive with `set`.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          - don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           items:
             type: string
           type: array
@@ -2201,14 +2198,14 @@ components:
             Removes the provided artifacts from the comment. If an artifact is
             not present, then it's ignored. Mututally exclusive with `set`.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          - don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           items:
             type: string
           type: array
         set:
           description: Sets the field to the provided artifacts.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          - don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           items:
             type: string
           type: array
@@ -2253,11 +2250,34 @@ components:
     timeline-entry-visibility:
       description: |
         The visibility of the entry. If 'private', then the entry is only
-        visible to the creator, otherwise if not set, then the entry has
-        default visibility.
+        visible to the creator, 'internal' is visible with the Dev
+        organization, 'external' is visible to the Dev organzation and Rev
+        users, and 'public' is visible to all. If not set, then the default
+        visibility is 'external'.
       enum:
+      - external
+      - internal
       - private
+      - public
       type: string
+    timeline-snap-kit-body:
+      description: Snap Kit Body of the comment.
+      properties:
+        body:
+          description: The JSON body of the SnapKit.
+          type: object
+        snap_in_action_name:
+          description: |
+            The name of an action defined in the SnapIn. The combination of
+            snap_in_id and snap_in_action_name uniquely identifies the
+            interaction object which is to be called when actions on a snapkit
+            element is taken.
+          type: string
+        snap_in_id:
+          description: ID of the snap-in which created the SnapKit.
+          type: string
+      title: timeline-snap-kit-body
+      type: object
     user-base:
       allOf:
       - $ref: '#/components/schemas/atom-base'
@@ -2407,7 +2427,7 @@ components:
           $ref: '#/components/schemas/event-webhook-deleted'
         webhook_id:
           description: ID of the webhook for the event.
-          example: don:<partition>:integration:devo/<dev-org-id>:webhook/<webhook-id>
+          example: don:integration:<partition>:devo/<dev-org-id>:webhook/<webhook-id>
           type: string
         webhook_updated:
           $ref: '#/components/schemas/event-webhook-updated'
@@ -2511,7 +2531,7 @@ components:
       properties:
         id:
           description: ID for the webhook.
-          example: don:<partition>:integration:devo/<dev-org-id>:webhook/<webhook-id>
+          example: don:integration:<partition>:devo/<dev-org-id>:webhook/<webhook-id>
           type: string
       required:
       - id
@@ -2560,7 +2580,7 @@ components:
           $ref: '#/components/schemas/webhooks-update-request-event-types'
         id:
           description: ID for the webhook.
-          example: don:<partition>:integration:devo/<dev-org-id>:webhook/<webhook-id>
+          example: don:integration:<partition>:devo/<dev-org-id>:webhook/<webhook-id>
           type: string
         secret:
           description: |
@@ -2698,13 +2718,13 @@ components:
             The [part](https://devrev.ai/docs/product/parts) that the work
             applies to. Specifying a part is required when creating tickets and
             issues.
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
         artifacts:
           description: |
             The IDs of the artifacts to associate with the work item.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          - don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           items:
             type: string
           type: array
@@ -2713,20 +2733,22 @@ components:
           type: string
         custom_schema_fragments:
           description: The custom schema fragments to use.
+          example:
+          - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
           items:
             type: string
           type: array
         owned_by:
           description: The users that own the work.
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
         reported_by:
           description: The users that reported the work.
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -2769,7 +2791,7 @@ components:
           type: string
         rev_org:
           description: The Rev organization that the ticket is associated with.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
         severity:
           $ref: '#/components/schemas/ticket-severity'
@@ -2788,7 +2810,7 @@ components:
       properties:
         id:
           description: The work's ID.
-          example: don:<partition>:core:devo/<dev-org-id>:<work-type>/<work-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<work-type>/<work-id>
           type: string
       required:
       - id
@@ -2854,7 +2876,7 @@ components:
       properties:
         applies_to_part:
           description: Updates the part that the work applies to.
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
         artifacts:
           $ref: '#/components/schemas/works-update-request-artifact-ids'
@@ -2864,12 +2886,14 @@ components:
           type: string
         custom_schema_fragments:
           description: The custom schema fragments to use.
+          example:
+          - don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>
           items:
             type: string
           type: array
         id:
           description: The work's ID.
-          example: don:<partition>:core:devo/<dev-org-id>:<work-type>/<work-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<work-type>/<work-id>
           type: string
         owned_by:
           $ref: '#/components/schemas/works-update-request-owned-by'
@@ -2900,7 +2924,7 @@ components:
         set:
           description: Sets the IDs to the provided artifact IDs.
           example:
-          - don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          - don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           items:
             type: string
           type: array
@@ -2923,7 +2947,7 @@ components:
             Sets the owner IDs to the provided user IDs. This must not be
             empty.
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -2935,7 +2959,7 @@ components:
           description: |
             Sets the users that reported the work to the provided user IDs.
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -2958,7 +2982,7 @@ components:
         rev_org:
           description: |
             Updates the Rev organization that the ticket is associated with.
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           nullable: true
           type: string
         severity:
@@ -2999,7 +3023,7 @@ paths:
         name: id
         required: true
         schema:
-          example: don:<partition>:core:devo/<dev-org-id>:artifact/<artifact-id>
+          example: don:core:<partition>:devo/<dev-org-id>:artifact/<artifact-id>
           type: string
       responses:
         "200":
@@ -3650,7 +3674,7 @@ paths:
         name: id
         required: true
         schema:
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
       responses:
         "200":
@@ -3687,7 +3711,7 @@ paths:
         name: created_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -3729,7 +3753,7 @@ paths:
         name: owned_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -3870,7 +3894,7 @@ paths:
         name: id
         required: true
         schema:
-          example: don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          example: don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           type: string
       responses:
         "200":
@@ -4117,7 +4141,7 @@ paths:
         name: id
         required: true
         schema:
-          example: don:<partition>:core:devo/<dev-org-id>:tag/<tag-id>
+          example: don:core:<partition>:devo/<dev-org-id>:tag/<tag-id>
           type: string
       responses:
         "200":
@@ -4264,6 +4288,7 @@ paths:
         name: id
         required: true
         schema:
+          example: don:core:<partition>:devo/<dev-org-id>:ticket/123:timeline_event/<timeline-event-id>
           type: string
       responses:
         "200":
@@ -4299,7 +4324,7 @@ paths:
         name: object
         required: true
         schema:
-          example: don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           type: string
       - description: |
           The cursor to resume iteration from. If not provided, then iteration
@@ -4326,6 +4351,17 @@ paths:
         name: mode
         schema:
           $ref: '#/components/schemas/list-mode'
+      - description: |
+          The visibility of the timeline entries to filter for. Note this is a
+          strict filter, such that only entries with the exact visibilities
+          specified will be returned.
+        explode: false
+        in: query
+        name: visibility
+        schema:
+          items:
+            $ref: '#/components/schemas/timeline-entry-visibility'
+          type: array
       responses:
         "200":
           content:
@@ -4452,7 +4488,7 @@ paths:
         name: id
         required: true
         schema:
-          example: don:<partition>:integration:devo/<dev-org-id>:webhook/<webhook-id>
+          example: don:integration:<partition>:devo/<dev-org-id>:webhook/<webhook-id>
           type: string
       responses:
         "200":
@@ -4609,7 +4645,7 @@ paths:
         name: applies_to_part
         schema:
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           type: array
@@ -4619,7 +4655,7 @@ paths:
         name: created_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -4647,7 +4683,7 @@ paths:
         name: issue.rev_orgs
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          - don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           items:
             type: string
           type: array
@@ -4657,7 +4693,7 @@ paths:
         name: owned_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -4669,6 +4705,14 @@ paths:
           items:
             type: string
           type: array
+      - description: Filters for tickets belonging to specific groups.
+        explode: false
+        in: query
+        name: ticket.group
+        schema:
+          items:
+            type: string
+          type: array
       - description: |
           Filters for tickets that are associated with any of the provided Rev
           organizations.
@@ -4677,7 +4721,7 @@ paths:
         name: ticket.rev_org
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          - don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           items:
             type: string
           type: array
@@ -4729,7 +4773,7 @@ paths:
         name: id
         required: true
         schema:
-          example: don:<partition>:core:devo/<dev-org-id>:<work-type>/<work-id>
+          example: don:core:<partition>:devo/<dev-org-id>:<work-type>/<work-id>
           type: string
       responses:
         "200":
@@ -4765,7 +4809,7 @@ paths:
         name: applies_to_part
         schema:
           example:
-          - don:<partition>:core:devo/<dev-org-id>:<part-type>/<part-id>
+          - don:core:<partition>:devo/<dev-org-id>:<part-type>/<part-id>
           items:
             type: string
           type: array
@@ -4775,7 +4819,7 @@ paths:
         name: created_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -4802,7 +4846,7 @@ paths:
         name: issue.rev_orgs
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          - don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           items:
             type: string
           type: array
@@ -4828,7 +4872,7 @@ paths:
         name: owned_by
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:devu/<dev-user-id>
+          - don:identity:<partition>:devo/<dev-org-id>:devu/<dev-user-id>
           items:
             type: string
           type: array
@@ -4840,6 +4884,14 @@ paths:
           items:
             type: string
           type: array
+      - description: Filters for tickets belonging to specific groups.
+        explode: false
+        in: query
+        name: ticket.group
+        schema:
+          items:
+            type: string
+          type: array
       - description: |
           Filters for tickets that are associated with any of the provided Rev
           organizations.
@@ -4848,7 +4900,7 @@ paths:
         name: ticket.rev_org
         schema:
           example:
-          - don:<partition>:identity:devo/<dev-org-id>:revo/<rev-org-id>
+          - don:identity:<partition>:devo/<dev-org-id>:revo/<rev-org-id>
           items:
             type: string
           type: array