Change success to output

Author: maxvp

src/content/partials/cloudflare-one/gateway/get-started/create-dns-policy.mdx

@@ -29,13 +29,13 @@ To create a new DNS policy:
    | ------- | ---------- | ---------- |
    | Account | Zero Trust | Edit       |
 
-2. (Optional) Configure your API environment variables to include your [account ID](/fundamentals/setup/find-account-and-zone-ids/), email address, and API token.
+2. (Optional) Configure your API environment variables to include your [account ID](/fundamentals/setup/find-account-and-zone-ids/) and API token.
 3. Send a `POST` request to the [Create a Zero Trust Gateway rule](/api/operations/zero-trust-gateway-rules-create-zero-trust-gateway-rule) endpoint. For example, we recommend adding a policy to block all [security categories](/cloudflare-one/policies/gateway/domain-categories/#security-categories):
 
-   ```bash title="curl API example"
+   ```sh title="curl API DNS policy example"
    curl https://api.cloudflare.com/client/v4/accounts/{account_id}/gateway/rules \
-   --header "X-Auth-Email: <EMAIL>" \
-   --header "X-Auth-Key: <API_KEY>" \
+   --header "Content-Type: application/json" \
+   --header "Authorization: Bearer <API_TOKEN>" \
    --data '{
    "name": "Block security risks",
    "description": "Block all default Cloudflare DNS security categories",
@@ -51,7 +51,15 @@ To create a new DNS policy:
    }'
    ```
 
-   If Gateway successfully created the policy, the API will respond with a `success` value of `true`.
+   ```sh output
+   {
+   	"success": true,
+   	"errors": [],
+   	"messages": []
+   }
+   ```
+
+   The API will respond with a summary of the policy and the result of your request.
 
 </TabItem> </Tabs>
 

src/content/partials/cloudflare-one/gateway/get-started/create-http-policy.mdx

@@ -38,44 +38,52 @@ To create a new HTTP policy:
    | ------- | ---------- | ---------- |
    | Account | Zero Trust | Edit       |
 
-2. (Optional) Configure your API environment variables to include your [account ID](/fundamentals/setup/find-account-and-zone-ids/), email address, and API token.
+2. (Optional) Configure your API environment variables to include your [account ID](/fundamentals/setup/find-account-and-zone-ids/) and API token.
 3. Send a `POST` request to the [Create a Zero Trust Gateway rule](/api/operations/zero-trust-gateway-rules-create-zero-trust-gateway-rule) endpoint. For example, if you have enabled TLS decryption, some applications that use [embedded certificates](/cloudflare-one/policies/gateway/http-policies/tls-decryption/#inspection-limitations) may not support HTTP inspection, such as some Google products. You can create a policy to bypass inspection for these applications:
 
-   ```bash title="curl API example"
+   ```sh title="curl API HTTP policy example"
    curl https://api.cloudflare.com/client/v4/accounts/{account_id}/gateway/rules \
-   --header "X-Auth-Email: <EMAIL>" \
-   --header "X-Auth-Key: <API_KEY>" \
+   --header "Content-Type: application/json" \
+   --header "Authorization: Bearer <API_TOKEN>" \
    --data '{
    "name": "Do not inspect applications",
    "description": "Bypass TLS decryption for unsupported applications",
    "precedence": 0,
    "enabled": true,
    "action": "off",
    "filters": [
-   	"http"
+   "http"
    ],
    "traffic": "any(app.type.ids[*] in {16})",
    "identity": "",
    "device_posture": ""
    }'
    ```
 
-   If Gateway successfully created the policy, the API will respond with a `success` value of `true`.
+   ```sh output
+   {
+   	"success": true,
+   	"errors": [],
+   	"messages": []
+   }
+   ```
+
+   The API will respond with a summary of the policy and the result of your request.
 
    Cloudflare also recommends adding a policy to block [known threats](/cloudflare-one/policies/gateway/domain-categories/#security-categories) such as Command & Control, Botnet and Malware based on Cloudflare's threat intelligence:
 
-   ```bash title="curl API example"
+   ```bash title="Block known risks HTTP policy"
    curl https://api.cloudflare.com/client/v4/accounts/{account_id}/gateway/rules \
-   --header "X-Auth-Email: <EMAIL>" \
-   --header "X-Auth-Key: <API_KEY>" \
+   --header "Content-Type: application/json" \
+   --header "Authorization: Bearer <API_Token>" \
    --data '{
-   "name": "Block security categories",
+   "name": "Block known risks",
    "description": "Block all default Cloudflare HTTP security categories",
    "precedence": 0,
    "enabled": true,
    "action": "block",
    "filters": [
-   	"http"
+   "http"
    ],
    "traffic": "any(http.request.uri.security_category[*] in {68 178 80 83 176 175 117 131 134 151 153})",
    "identity": "",

src/content/partials/cloudflare-one/gateway/get-started/create-network-policy.mdx

@@ -29,13 +29,13 @@ To create a new network policy:
    | ------- | ---------- | ---------- |
    | Account | Zero Trust | Edit       |
 
-2. (Optional) Configure your API environment variables to include your [account ID](/fundamentals/setup/find-account-and-zone-ids/), email address, and API token.
+2. (Optional) Configure your API environment variables to include your [account ID](/fundamentals/setup/find-account-and-zone-ids/) and API token.
 3. Send a `POST` request to the [Create a Zero Trust Gateway rule](/api/operations/zero-trust-gateway-rules-create-zero-trust-gateway-rule) endpoint. For example, you can use a list of [device serial numbers](/cloudflare-one/identity/devices/warp-client-checks/corp-device/) to ensure users can only access an application if they connect with the WARP client from a company device:
 
-   ```bash title="curl API example"
+   ```sh title="curl API network policy example"
    curl https://api.cloudflare.com/client/v4/accounts/{account_id}/gateway/rules \
-   --header "X-Auth-Email: <EMAIL>" \
-   --header "X-Auth-Key: <API_KEY>" \
+   --header "Content-Type: application/json" \
+   --header "Authorization: Bearer <API_TOKEN>" \
    --data '{
    "name": "Enforce device posture",
    "description": "Ensure only devices in Zero Trust organization can connect to application",
@@ -51,7 +51,15 @@ To create a new network policy:
    }'
    ```
 
-   If Gateway successfully created the policy, the API will respond with a `success` value of `true`.
+   ```sh output
+   {
+   	"success": true,
+   	"errors": [],
+   	"messages": []
+   }
+   ```
+
+   The API will respond with a summary of the policy and the result of your request.
 
 </TabItem> </Tabs>