change formatting & order within sidebar

Author: TC-MO

apify-api/openapi/components/tags.yaml

@@ -30,7 +30,7 @@
   description: |
     The API endpoints in this section allow you to manage your Apify Actors versions.
 
-    - The _Version object_ contains the source code of a specific version of an Actor.
+    - The version object contains the source code of a specific version of an Actor.
     - The `sourceType` property indicates where the source code is hosted, and based
     on its value the Version object has the following additional property:
 
@@ -53,6 +53,8 @@
   - '#tag/ActorsBuild-object'
   - '#tag/ActorsAbort-build'
   x-trait: 'true'
+  description: |
+    The API endpoints in this section allow you to manage your Apify Actors builds.
 - name: Actors/Actor runs
   x-displayName: Actor runs
   x-parent-tag-name: Actors
@@ -69,7 +71,7 @@
   - '#/reference/actors/run-actor-synchronously-and-get-dataset-items'
   - '#tag/ActorsRun-Actor-synchronously-and-get-dataset-items'
   description: |
-    The API endpoints in this section allow you to run Apify Actors.
+    The API endpoints in this section allow you to manage your Apify Actors runs.
 
     Some API endpoints return run objects. If a run object includes usage costs in dollars, note that these values are calculated based on your effective unit pricing at the time of the query. As a result, the dollar amounts should be treated as informational only and not as exact figures.
 

apify-api/openapi/openapi.yaml

@@ -499,28 +499,28 @@ paths:
     $ref: 'paths/actors/acts@{actorId}@webhooks.yaml'
   '/v2/acts/{actorId}/builds':
     $ref: 'paths/actors/acts@{actorId}@builds.yaml'
-  '/v2/acts/{actorId}/builds/{buildId}':
-    $ref: 'paths/actors/acts@{actorId}@builds@{buildId}.yaml'
   '/v2/acts/{actorId}/builds/default':
     $ref: 'paths/actors/acts@{actorId}@[email protected]'
-  '/v2/acts/{actorId}/builds/{buildId}/abort':
-    $ref: 'paths/actors/acts@{actorId}@builds@{buildId}@abort.yaml'
   '/v2/acts/{actorId}/builds/{buildId}/openapi.json':
     $ref: 'paths/actors/acts@{actorId}@builds@{buildId}@openapi.json.yaml'
+  '/v2/acts/{actorId}/builds/{buildId}':
+    $ref: 'paths/actors/acts@{actorId}@builds@{buildId}.yaml'
+  '/v2/acts/{actorId}/builds/{buildId}/abort':
+    $ref: 'paths/actors/acts@{actorId}@builds@{buildId}@abort.yaml'
   '/v2/acts/{actorId}/runs':
     $ref: 'paths/actors/acts@{actorId}@runs.yaml'
   '/v2/acts/{actorId}/run-sync':
     $ref: 'paths/actors/acts@{actorId}@run-sync.yaml'
   '/v2/acts/{actorId}/run-sync-get-dataset-items':
     $ref: 'paths/actors/acts@{actorId}@run-sync-get-dataset-items.yaml'
+  '/v2/acts/{actorId}/runs/{runId}/resurrect':
+    $ref: 'paths/actors/acts@{actorId}@runs@{runId}@resurrect.yaml'
   '/v2/acts/{actorId}/runs/{runId}':
     $ref: 'paths/actors/acts@{actorId}@runs@{runId}.yaml'
   '/v2/acts/{actorId}/runs/{runId}/abort':
     $ref: 'paths/actors/acts@{actorId}@runs@{runId}@abort.yaml'
   '/v2/acts/{actorId}/runs/{runId}/metamorph':
     $ref: 'paths/actors/acts@{actorId}@runs@{runId}@metamorph.yaml'
-  '/v2/acts/{actorId}/runs/{runId}/resurrect':
-    $ref: 'paths/actors/acts@{actorId}@runs@{runId}@resurrect.yaml'
   '/v2/acts/{actorId}/runs/last':
     $ref: 'paths/actors/acts@{actorId}@[email protected]'
   /v2/actor-tasks: