fixup! feat: update LiveObjects usage docs

Author: kaschula

src/pages/docs/liveobjects/rest-api-usage.mdx

@@ -39,7 +39,7 @@ The key in the `data` object indicates the type of the value:
 `bytes` values use base64 string encoding in JSON request and response bodies.
 </Aside>
 
-## Fetch the channel object <a id="fetching-objects"/>
+## Fetch the channel object <a id="fetch-object"/>
 
 ### Get the entire object <a id="fetching-object-get"/>
 
@@ -68,7 +68,7 @@ This endpoint by default returns the compact representation of the object tree.
   ```
 </Code>
 
-#### Get the entire object with metatdata <a id="fetching-object-get-full-object"/>
+#### Get the entire object with metatdata <a id="fetching-object"/>
 
 By providing the `compact=false` query param the response will contain the full object representation including the
 objectIds.
@@ -140,7 +140,7 @@ objectIds.
 
 Both these requests are billed per object returned.
 
-#### Get a subset of the object <a id="fetching-object-get-with-path"/>
+#### Get a subset of the object <a id="fetch-object-with-path"/>
 
 You can return a subset of the object tree by specifying the `path` query param. For example, to return just the `poll` `LiveMap` instance from the root object:
 
@@ -166,8 +166,7 @@ You can return a subset of the object tree by specifying the `path` query param.
 
 Note you will be only billed for the objects contained within the path.
 
-
-### Get a single object by id <a id="fetching-objects-get-single"/>
+### Get an object by id <a id="fetch-object-get-by-id"/>
 
 `GET main.realtime.ably.net/channels/<channelName>/object/<objectId>`
 

static/open-specs/liveobjects.yaml

@@ -20,7 +20,7 @@ paths:
       description: |
         Publish operations to create or update objects on the channel.<br><br>
 
-        For more information, see the usage documentation for [publishing operations](/docs/liveobjects/rest-api-usage#updating-objects).
+        For more information, see the usage documentation for [publishing operations](/docs/liveobjects/rest-api-usage#publishing-operations).
       parameters:
         - name: channelId
           in: path
@@ -238,7 +238,7 @@ paths:
         If the path param is not provided then the root object is returned. If the compact param is not provided
         then the response defaults to the compact format.<br><br>
 
-        For more information, see the usage documentation for [get object](/docs/liveobjects/rest-api-usage#fetching-objects-get).
+        For more information, see the usage documentation for [get object](/docs/liveobjects/rest-api-usage#fetch-object).
 
       parameters:
         - name: channelId
@@ -465,7 +465,7 @@ paths:
         If the compact param is not provided then the response defaults to the compact format. The path query
         param can be used to request a value from the provided object ID's children.
 
-        For more information, see the usage documentation for [get object](/docs/liveobjects/rest-api-usage#fetching-objects-get).
+        For more information, see the usage documentation for [get object by ID](/docs/liveobjects/rest-api-usage#fetch-object-get-by-id).
       parameters:
         - name: channelName
           in: path
@@ -698,7 +698,7 @@ paths:
 
         DEPRECATED: please use `POST /channels/{channelName}/object` instead.<br><br>
 
-        For more information, see the usage documentation for [publishing operations](/docs/liveobjects/rest-api-usage#updating-objects).
+        For more information, see the usage documentation for [publishing operations](/docs/liveobjects/rest-api-usage#publishing-operations).
       parameters:
         - name: channelName
           in: path
@@ -916,8 +916,6 @@ paths:
         Fetch a flat list of objects on the channel.<br><br>
 
         DEPRECATED: please use `GET /channels/{channelName}/object` instead.<br><br>
-
-        For more information, see the usage documentation for [list objects](/docs/liveobjects/rest-api-usage#fetching-objects).
       parameters:
         - name: channelName
           in: path
@@ -929,27 +927,27 @@ paths:
         - name: values
           in: query
           required: false
-          description: If `true`, includes the values of objects in the response. See [including values](/docs/liveobjects/rest-api-usage#fetching-objects-list-values).
+          description: If `true`, includes the values of objects in the response.
           schema:
             type: boolean
             default: false
         - name: metadata
           in: query
           required: false
-          description: If `true`, includes additional object [metadata](/docs/liveobjects/concepts/objects#metadata) in the response. See [including metadata](/docs/liveobjects/rest-api-usage#fetching-objects-list-metadata).
+          description: If `true`, includes additional object [metadata](/docs/liveobjects/concepts/objects#metadata) in the response.
           schema:
             type: boolean
             default: false
         - name: limit
           in: query
           required: false
-          description: Specifies the maximum number of objects to include in the response. See [pagination](/docs/liveobjects/rest-api-usage#fetching-objects-list-pagination).
+          description: Specifies the maximum number of objects to include in the response.
           schema:
             type: integer
         - name: cursor
           in: query
           required: false
-          description: The object ID to use as a cursor for pagination. See [pagination](/docs/liveobjects/rest-api-usage#fetching-objects-list-pagination).
+          description: The object ID to use as a cursor for pagination.
           schema:
             $ref: '#/components/schemas/ObjectIdString'
       responses:
@@ -1160,8 +1158,6 @@ paths:
         Fetch an object by ID, optionally including its children.<br><br>
         DEPRECATED: please use GET /channels/{channelName}/object?compact=false or
         /channels/{channelName}/object/{objectId}?compact=false instead.<br><br>
-
-        For more information, see the usage documentation for [get objects](/docs/liveobjects/rest-api-usage#fetching-objects-get).
       parameters:
         - name: channelName
           in: path
@@ -1180,15 +1176,15 @@ paths:
           in: query
           required: false
           description: |
-            Fetch the objects on the channel in a tree structure starting from the specified [object ID](/docs/liveobjects/concepts/objects#object-ids).
-            Nested child objects are resolved and their values are included in the response. See [Get an object and its children](/docs/liveobjects/rest-api-usage#fetching-objects-get-children).
+            Fetch the objects on the channel in a tree structure starting from the specified [object ID](/docs/liveobjects/concepts/objects#fetch-object-by-id).
+            Nested child objects are resolved and their values are included in the response.
           schema:
             type: boolean
             default: false
         - name: metadata
           in: query
           required: false
-          description: If `true`, includes additional object [metadata](/docs/liveobjects/concepts/objects#metadata) in the response. See [including metadata](/docs/liveobjects/rest-api-usage#fetching-objects-get-metadata).
+          description: If `true`, includes additional object.
           schema:
             type: boolean
             default: false
@@ -1374,7 +1370,6 @@ paths:
       description: |
         Fetch the objects on the channel in a tree structure in a concise format.<br><br>
         DEPRECATED: please use GET /channels/{channelName}/object or /channels/{channelName}/object/{objectId} instead.<br><br>
-        For more information, see the usage documentation for [get a compact view of objects](/docs/liveobjects/rest-api-usage#fetching-objects-compact).
       parameters:
         - name: channelName
           in: path
@@ -1801,7 +1796,7 @@ components:
           $ref: '#/components/schemas/ObjectIdString'
         path:
           type: string
-          description: The [path](/docs/liveobjects/rest-api-usage#updating-objects-by-path) from the root to the object.
+          description: The [path](/docs/liveobjects/rest-api-usage#fetch-object-with-path) from the root to the object.
           example: "votes.up"
 
     OperationMapSet: