changes & updates

changed inline code for code block in authorization section
removed requests body & responses
changed placement of verification endpoint
moved log & monitor endpoints to additinal operations section
swapped sync & async run endpoints

Author: TC-MO

sources/api/getting-started.mdx

@@ -34,70 +34,60 @@ Before you can start using the API, check if you have all the necessary prerequi
 
 You must authenticate all API requests presented on this page. You can authenticate using your API token:
 
-`Authorization: Bearer YOUR_API_TOKEN`
+```http
+Authorization: Bearer YOUR_API_TOKEN
+```
 
 You can find your API token in the Apify Console under **[Settings > Integrations](https://console.apify.com/settings/integrations)**.
 
-## Basic workflow
-
-A most common workflow involving Apify API consists of the following steps:
-
-1. Running an Actor.
-1. Monitoring the status of a run.
-1. Retrieving the results.
-1. Retrieving log for troubleshooting purposes. - optional
-
-### 1. Run an Actor
+### Verify your account
 
-#### Asynchronously
+To check your API credentials or account details:
 
 ```http title="Endpoint"
-POST https://api.apify.com/v2/acts/{actorId}/runs
+GET https://api.apify.com/v2/users/me
 ```
 
-```json title="Request body"
-TODO
-```
+Expected response codes:
 
-```json title="Response"
-TODO
-```
+* `200`
 
-Expected response codes:
+## Basic workflow
 
-* 201
+A most common workflow involving Apify API consists of the following steps:
+
+1. Running an Actor.
+1. Retrieving the results.
+
+### 1. Run an Actor
 
 #### Synchronously
 
-For shorter runs where you need immediate results:
+For shorter runs where you need immiediate results:
 
 ```http title="Endpoint"
 POST https://api.apify.com/v2/acts/{actorId}/run-sync
 ```
 
-The request body is the same as for asynchronous runs, but the response will include the complete results once the Actor finishes.
-
 Expected response codes:
 
-* 201
-* 400
-* 408
+* `201`
+* `400`
+* `408`
 
-### 2. Monitor run status
+#### Asynchronously
 
 ```http title="Endpoint"
-GET https://api.apify.com/v2/actor-runs/:runId
+POST https://api.apify.com/v2/acts/{actorId}/runs
 ```
 
-``` json title="Response"
-TODO
-```
+The request body is the same as for asynchronous runs, but the response will include the complete results once the Actor finishes.
 
-Expected response code:
+Expected response codes:
 
-* 200
+* `201`
 
-### 3. Retrieve results
+### 2. Retrieve results
 
 #### From a Dataset
 
@@ -121,7 +111,7 @@ Optional query parameters:
 
 Expected code responses:
 
-* 200
+* `200`
 
 #### From a Key-value store
 
@@ -131,10 +121,12 @@ GET https://api.apify.com/v2/key-value-stores/{storeId}/records/{recordKey}
 
 Expected response codes:
 
-* 200
-* 302
+* `200`
+* `302`
+
+### Additional operations
 
-### Get log
+#### Get log
 
 You can get a log for a specific run or build of an Actor.
 
@@ -144,35 +136,46 @@ GET https://api.apify.com/v2/logs/:buildOrRunId
 
 Expected code responses:
 
-* 200
+* `200`
 
-### Additional operations
+#### Monitor run status
 
-#### Store data in Key-value store
+```http title="Endpoint"
+GET https://api.apify.com/v2/actor-runs/:runId
+```
 
-To store your own data in a Key-value store:
+Expected response code:
+
+* `200`
+
+#### Store data in Dataset
+
+To store your own data in a Dataset:
 
 ```http title="Endpoint"
-PUT https://api.apify.com/v2/key-value-stores/{storeId}/records/{recordKey}
+POST https://api.apify.com/v2/datasets/:datasetId/items
 ```
 
-Include your data in the request body and set the appropriate `Content-Type` header.
+If any of the items received by the API fails the validation, whole request is discarded.
 
 Expected response codes:
 
-* 201
+* `201`
+* `400`
 
-#### Verify your account
+#### Store data in Key-value store
 
-To check your API credentials or account details:
+To store your own data in a Key-value store:
 
 ```http title="Endpoint"
-GET https://api.apify.com/v2/users/me
+PUT https://api.apify.com/v2/key-value-stores/{storeId}/records/{recordKey}
 ```
 
+Include your data in the request body and set the appropriate `Content-Type` header.
+
 Expected response codes:
 
-* 200
+* `201`
 
 ## Next steps