Minimize confusion about delete by query endpoint

Author: fredsted

docs/api/about.md

@@ -26,6 +26,7 @@ You must set the [`Api-Key`](#api-key) header if you have a Webhook.site account
 * In API URLs, you *cannot* use Token Aliases in place of the Token ID.
 * Webhook.site API Keys *must* be specified using the `Api-Key` HTTP header.
 * Fair use guidelines, rate limits, and other limitations apply as described by the [Terms of Service](https://webhook.site/terms).
+* If you're interacting with Tokens or Requests, make sure you keep the `/token/` part! (Otherwise Webhook.site won't recognize it as an API URL.)
 
 ## API Key
 

docs/api/requests.md

@@ -321,15 +321,15 @@ Deletes all requests associated with the token, or if `query`, `date_from` and/o
 
 ### Query string parameters
 
-* `date_from`, `date_to` - filter requests by date, format `yyyy-MM-dd HH:mm:ss`
-* `query` - filter requests by a query string search. [See here for examples](#search-query-examples).
+* `date_from`, `date_to` - filter requests by date (format `yyyy-MM-dd HH:mm:ss`) or [date expressions](/api/date-expressions.html).
+* `query` - filter requests by a Search Query. [See here for examples](#search-query-examples).
 
 
 ### Full URL Example
 
-A request to the following URL will delete all requests on a Token older than 14 days, due to the `query` parameter being `created_at:[* TO now-14d]`. You could use this in a [Webhook.site Schedule](/schedules.html) to delete old requests from a URL periodically.
+A request to the following URL will delete all requests on a Token older than 7 days, due to the `date_to` parameter being `now-7d`. You could use this in a [Webhook.site Schedule](/schedules.html) to delete old requests from a URL periodically.
 
-`https://webhook.site/token/00000000-0000-0000-0000-000000000000/request?query=created_at:[* TO now-14d]`
+<code>https://webhook.site/token/<span class="url-param">tokenId</span>/request?date_to=<span class="url-param">now-7d</span></code>
 
 ### Response
 

docs/index.md

@@ -152,15 +152,16 @@ Using the Webhook.site API (specifically, the [Delete Multiple Requests endpoint
 
 To set it up, first, [create an API Key](https://webhook.site/api-keys). 
 
-Then create a Schedule like the following screenshot. 
+Then [create a Schedule](https://webhook.site/control-panel/schedules/create) like the following screenshot. 
 
-In this example, Webhook.site will remove data older than 14 days every 24 hours. `now-12h` would be 12 hours. [More date format examples](/api/date-expressions.html).
+In this example, Webhook.site will remove data older than 7 days every 24 hours. (`now-12h` would be 12 hours. [More date format examples](/api/date-expressions.html)).
 
-Remember to click the URL Encode button before saving.
-
-* URL: `https://webhook.site/token/00000000-0000-0000-000000000/request?query=created_at:[* TO now-14d]` - replace `00000000-0000-0000-000000000` with the URL/Token ID.
+* URL: <code>https://webhook.site/token/<span class="url-param">tokenId</span>/request?date_to=now-7d</code>
+    * Replace `tokenId` with the URL/Token ID. Make sure to keep the `/token/` part, though!
+    * Make sure to click the *URL Encode* button after entering the URL.
 * Method: `DELETE`
-* Headers: `Api-Key: 00000000-0000-0000-000000000` - replace `00000000-0000-0000-000000000` with your API key.
+* Headers: `Api-Key: 00000000-0000-0000-000000000`
+    * Replace `00000000-0000-0000-000000000` with your API key.
 
 <figure markdown="span">
   ![Automatically remove requests with Schedules](/images/schedule-autodelete.png){ width="300" }
@@ -169,7 +170,7 @@ Remember to click the URL Encode button before saving.
 
 ## What's a Webhook.site "Token"?
 
-A *Token* is how a Webhook.site URL is referred to in our API, it's the technical name for it. A *Token* corresponds to a unique UUID, which is also the Web address, email address and DNSHook address. A Token acts as a container for requests, emails and DNS queries. [More about Tokens](/api/tokens.html)
+A *Token* is how a Webhook.site URL is referred to in our API, it's the technical name for it. A *Token* corresponds to a unique [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier), which is also the Web address, email address and DNSHook address. A Token acts as a container for requests, emails and DNS queries. [More about Tokens](/api/tokens.html)
 
 ## How do I transfer my Webhook.site account and data?