diff --git a/docs.json b/docs.json
index 5da2f46..ab1894f 100644
--- a/docs.json
+++ b/docs.json
@@ -1,6 +1,6 @@
{
"$schema": "https://mintlify.com/docs.json",
- "theme": "palm",
+ "theme": "mint",
"name": "Requestly",
"description": "Modify, Mock, Record & Debug HTTP requests - Comprehensive documentation for Requestly's powerful tools for API testing, debugging, and network request manipulation.",
"colors": {
@@ -15,11 +15,16 @@
},
"favicon": "/images/favicon.webp",
"navbar": {
- "links": [],
+ "links": [
+ {
+ "label": "Go to Dashboard",
+ "href": "https://app.requestly.io/signup?utm_source=docs&utm_medium=navbar&utm_campaign=get_started"
+ }
+ ],
"primary": {
"type": "button",
- "label": "Get Started",
- "href": "https://app.requestly.io"
+ "label": "Download",
+ "href": "https://requestly.com/downloads"
}
},
"navigation": {
@@ -57,11 +62,20 @@
{
"group": "Sending Requests",
"pages": [
- "general/api-client/send-api-request",
- "general/api-client/graphql-request",
- "general/api-client/authorization",
- "general/api-client/replay-request-from-history",
- "general/api-client/generate-client-code"
+ "general/api-client/send-api-request/overview",
+ {
+ "group": "Create Requests",
+ "pages": [
+ "general/api-client/send-api-request/create-requests/overview",
+ "general/api-client/send-api-request/create-requests/configure-request",
+ "general/api-client/send-api-request/create-requests/parameters-and-body",
+ "general/api-client/send-api-request/create-requests/request-headers",
+ "general/api-client/send-api-request/create-requests/generate-client-code"
+ ]
+ },
+ "general/api-client/send-api-request/graphql-request",
+ "general/api-client/send-api-request/authorization",
+ "general/api-client/send-api-request/replay-request-from-history"
]
},
{
@@ -965,12 +979,12 @@
"destination": "/general/api-client/rq-api-reference/rq-expect"
},
{
- "source":"/guides/modify-network-request-for-browserstack-local",
- "destination":"/guides/requestly-integration-browserstack-app-live"
+ "source": "/guides/modify-network-request-for-browserstack-local",
+ "destination": "/guides/requestly-integration-browserstack-app-live"
},
{
- "source":"/using-rules/modify-headers",
- "destination":"/general/http-rules/rule-types/modify-headers"
+ "source": "/using-rules/modify-headers",
+ "destination": "/general/http-rules/rule-types/modify-headers"
}
]
}
diff --git a/general/api-client/ai-test-generator.mdx b/general/api-client/ai-test-generator.mdx
index a3f9e63..36ff3fd 100644
--- a/general/api-client/ai-test-generator.mdx
+++ b/general/api-client/ai-test-generator.mdx
@@ -14,6 +14,9 @@ Simply describe what you want to validate in plain English. The agent analyzes y
**Note**: The Test Authoring Agent is available only on **Pro plans and above**.
+
+
+
## Getting Started with AI Test Cases Generator
diff --git a/general/api-client/authorization.mdx b/general/api-client/authorization.mdx
deleted file mode 100644
index 5a08cdb..0000000
--- a/general/api-client/authorization.mdx
+++ /dev/null
@@ -1,87 +0,0 @@
----
-title: Authorization
-label: Authorization
-slug: authorization
-description: >-
- Learn how to set up and use various API Authorization methods in Requestly,
- including API Key, Bearer Token, and Basic Auth, for secure API interactions.
-seoDescription: >-
- Learn how to set up and use various API Authorization methods in Requestly,
- including API Key, Bearer Token, and Basic Auth, for secure API interactions.
-visibility: PUBLIC
----
-***
-
-Requestly allows you to send authorization data along with your API requests. Authorization data confirms that the sender has permission to access the API.
-
-
-
-## Request Authorization
-
-Authorization data can be entered in the Authorization tab, which is available at both the collection and request levels. If auth data is specified at the collection level, all APIs in that collection will use it unless they have their own Authorization Data or have selected "NO-AUTH." Requestly automatically populates these authorization details in the relevant parts of the request, based on the selected auth type.
-
-## Steps to Add Authorization
-
-
-
- Click on any request or collection to begin setting up authorization.
-
-
-
-
-
- Navigate to the Authorization tab and select the appropriate authorization type from the dropdown menu. Supported authorization types include "No Auth," "Inherit auth from parent," "API Key," "Bearer Tokens," and "Basic Auth."
-
-
-
-
-
- Each authorization type has specific fields that must be filled. Below are the details for each type:
-
- #### No Auth
-
- Requestly won’t send authorization details with a request unless you specify an auth type. If your request doesn’t require authorization, select "No Auth" from the Auth Type dropdown list.
-
-
-
- #### Inherit Auth from Parent
-
- Requestly uses the auth applied at the parent level. The inherited properties are populated when the request is sent. This works for API requests and sub-collections.
-
-
-
- #### API Key
-
- Requestly allows you to send key-value pairs along with the request data. These can be added to either Headers or Query Params. Select "API Key" from the Auth Type list, then enter your key name and value. Choose "Header" or "Query Params" from the "Add to" dropdown list for their inclusion. Variable storage enhances security.
-
-
-
- #### Bearer Tokens
-
- Bearer tokens enable requests to authenticate using an access key such as a JSON Web Token (JWT). Tokens are included in the request header. Select "Bearer Token" from the Auth Type dropdown and enter the token value. For additional security, store the token in a variable and reference it by name.
-
-
-
- Requestly appends the token value to the text "Bearer" in the required format in the Authorization header.
-
- #### Basic Auth
-
- Basic authentication involves sending a verified username and password with your request. Select "Basic Auth" from the Auth Type dropdown. Enter your API username and password in the respective fields. For extra security, store these in variables.
-
-
-
- In the request headers, the Authorization header passes the API a Base64 encoded string representing the username and password, appended to the text "Basic."
-
-
-
- Click "Send" to ensure that the authorization data is sent along with the API request.
-
-
-
-## Variable Support and Export
-
-Requestly supports the use of variables in Authorization Values, allowing flexibility and reuse across multiple requests or collections. Variables can store sensitive data securely and simplify updates when values change. For instance, you can define API tokens or credentials as variables and reference them in authorization fields.
-
-
-
-While authorization data can be exported alongside requests or collections, note that variable values themselves are not exported. This ensures the security of sensitive data and prevents accidental sharing of confidential information. Users need to define variable values locally when importing shared requests or collections.
diff --git a/general/api-client/collection-runner-data-file.mdx b/general/api-client/collection-runner-data-file.mdx
index 2befbdf..76c5020 100644
--- a/general/api-client/collection-runner-data-file.mdx
+++ b/general/api-client/collection-runner-data-file.mdx
@@ -16,6 +16,8 @@ This enables you to iterate through your requests using multiple sets of input v
Use this feature to test APIs with dynamic inputs, such as running the same workflow for multiple users, IDs, or configurations.
+
+
### Using a Data File in Collection Runner
Follow these steps to run a collection with custom data:
diff --git a/general/api-client/import-export.mdx b/general/api-client/import-export.mdx
index 9f92529..f20d034 100644
--- a/general/api-client/import-export.mdx
+++ b/general/api-client/import-export.mdx
@@ -15,6 +15,9 @@ This section covers everything you need to know about:
* Exporting your collections or environments for sharing, syncing, or backup
+
+
+
## Supported Imports
* [Import from cURL](/general/api-client/import-export/import-from-curl)
diff --git a/general/api-client/import-export/import-openapi-spec.mdx b/general/api-client/import-export/import-openapi-spec.mdx
index 07d9c52..44dc378 100644
--- a/general/api-client/import-export/import-openapi-spec.mdx
+++ b/general/api-client/import-export/import-openapi-spec.mdx
@@ -7,6 +7,9 @@ Import your **OpenAPI Specification** files directly into the **Requestly,** and
This helps you bring your existing API definitions from Swagger, Postman, or your backend documentation straight into Requestly in just a few clicks.
+
+
+
## What You Can Import
The importer supports both **YAML** and **JSON** OpenAPI files. When you upload a spec, Requestly automatically reads the file and creates API collections and requests based on your defined endpoints.
diff --git a/general/api-client/import-packages-into-your-scripts.mdx b/general/api-client/import-packages-into-your-scripts.mdx
index 2c8f29c..9aa9e3c 100644
--- a/general/api-client/import-packages-into-your-scripts.mdx
+++ b/general/api-client/import-packages-into-your-scripts.mdx
@@ -7,6 +7,8 @@ You can use the `require` method to import preloaded libraries or global helpers
The script environment supports JavaScript-based transformations, validations, and dynamic request logic for HTTP and GraphQL APIs.
+
+
## **require**
The `require` method lets you import supported modules into your script. Declare the result as a variable to access functions or objects from that module.
diff --git a/general/api-client/overview.mdx b/general/api-client/overview.mdx
index 7e0d454..73e5807 100644
--- a/general/api-client/overview.mdx
+++ b/general/api-client/overview.mdx
@@ -173,13 +173,13 @@ Ready to start testing APIs? Follow these quick steps:
## Next Steps
-
- Deep dive into variable types and usage
+
+ New to API Client? Start here with our beginner-friendly guide
-
- Add automated testing to your workflow
+
+ Learn how to send API requests and view responses
-
- Share APIs with your team workspace
+
+ Organize your APIs into collections for better project management
diff --git a/general/api-client/send-api-request.mdx b/general/api-client/send-api-request.mdx
deleted file mode 100644
index d0af1fd..0000000
--- a/general/api-client/send-api-request.mdx
+++ /dev/null
@@ -1,241 +0,0 @@
----
-title: "Send API Request"
-label: "Send API Request"
-slug: "send-api-request"
-description: "Simplify API testing with Requestly. Send HTTP requests, view responses, and add parameters."
-seoTitle: "Send API Request"
-seoDescription: "Simplify API testing with Requestly. Send HTTP and GraphQL requests, view responses, and add parameters."
-visibility: "PUBLIC"
----
-
----
-
-The API client in Requestly allows you to easily send API requests, without the need for writing code or using a terminal. It lets you test APIs, retrieve data, and explore how they work by simply creating a request, clicking Send, and viewing the response within Requestly.
-
-This feature is perfect for developers testing API endpoints during development, QA engineers validating API responses for edge cases, and support engineers debugging API issues in real-time.
-
-
-
-## **Send Your First API Request**
-
-
-
- Click the **API Client** link in the left sidebar of the Requestly application, then click the `+ New` button to create a new request and select **Request** from the menu.
-
-
-
-
- Choose a descriptive title for your request to make it easy to identify later.
-
-
-
-
- Pick the HTTP method (e.g., GET, POST) and type the URL of the API you want to test.
-
-
-
-
- Click the **Save** & **Send** button to execute your request.
-
-
-
-
-
----
-
-## **Response**
-
-### **1. View the Response Body**
-
-Once the request is sent, check the response body in the **Response Body** section. You can switch between formatted (pretty) and raw views.
-
-
-
-### **2. Check the Response Headers**
-
-Review the headers sent back by the server in the **Headers** tab.
-
-
-
----
-
-## Path Variables
-
-Path variables allow you to define dynamic segments in your API URL using the `:variableName` syntax. This is useful for RESTful APIs where resource identifiers are part of the URL path.
-
-For example, if your API endpoint is:
-```
-https://api.example.com/users/:userId/posts/:postId
-```
-
-Requestly automatically detects the path variables (`:userId` and `:postId`) from the URL and displays them in the **Params** tab under **Path Variables**. You can then set values for each variable:
-
-| Key | Value | Description |
-|-----|-------|-------------|
-| userId | 123 | The user's unique identifier |
-| postId | 456 | The post's unique identifier |
-
-When you send the request, Requestly compiles the URL with your provided values:
-```
-https://api.example.com/users/123/posts/456
-```
-
-
- Path variables are automatically extracted from your URL. Simply type a URL with `:variableName` segments, and they'll appear in the Path Variables table for you to fill in.
-
-
----
-
-## Query Parameters
-
-In the **Query Params** section, you can add query parameters as **key-value pairs** to send extra information with the URL. To add more parameters, click on the `+ Add More` button.
-
-Each query parameter consists of:
-
-- **Key**: The parameter name
-- **Value**: The parameter value
-- **Type**: An enum to enforce the value type
-- **Description** (optional): Internal documentation explaining the purpose of the parameter
-
-For example:
-
-- Adding `uid=123` to `https://app.requestly.io/echo` results in: `https://app.requestly.io/echo?uid=123`
-
-
- The checkboxes next to each parameter let you include or exclude them without deleting them. For instance, if you uncheck the `Key` parameter, the final URL will not include it
-
-
-
-
-**Bulk Edit Query Parameters**\
-You can also manage query parameters using **Bulk Edit**. This allows you to add or update multiple parameters at once in a key:value format.
-
-- Add one parameter per line
-- Separate keys and values using a colon `:`
-- Prefix any line with `//` to disable that parameter
-
-Bulk Edit is useful when working with a large number of query parameters or when making quick mass updates.
-
-## Request Body
-
-For POST or PUT requests, use the **Body** tab to send data
-
-### Supported Form Types
-
-1. **RAW**
- - Send raw data as plain **text** or structured **JSON**.
- - You can select the language:
-
- **JSON** – for structured data like API payloads.\
- **Text** – for plain string or unstructured data
-
-
-2. **x-www-form-urlencoded**
- - Sends data as URL-encoded key-value pairs.
- - Commonly used for web for
-
-
-3. **multipart/form-data**
- - Used when uploading files along with form fields.
- - Each field is sent as a separate part of the request body.
- - Example use case: Uploading an image along with user detail
-
-
-
-> 💡 Tip: For both `x-www-form-urlencoded` and `multipart/form-data`, you can add fields using the key-value form editor. If you need to send files, choose **multipart/form-data**.
-
----
-
-## Headers
-
-The **Headers** tab allows you to include additional information in your API request. Headers are key-value pairs that provide essential details for the request, such as authentication tokens, content type, or other metadata required by the API. To add more headers, click on the `+ Add More` button.
-
-Each header consists of:
-
-- **Key**: The header name (e.g., `Authorization`, `Content-Type`)
-- **Value**: The header value
-- **Description** (optional): Internal documentation to explain the purpose of this header
-
-For example: You can add headers like `Authorization: Bearer ` to authenticate your request, or `Content-Type: application/json` to specify the format of the data you're sending.
-
-
- The checkboxes next to each parameter let you include or exclude them without deleting them. For instance, if you uncheck the `Key` parameter, the final URL will not include it
-
-
-
-
-**Bulk Edit Header**\
-You can also manage Headers using **Bulk Edit**. This allows you to add or update multiple headers at once in a key:value format.
-
-- Add one header-value pair per line
-- Separate keys and values using a colon `:`
-- Prefix any line with `//` to disable that parameter
-
-Bulk Edit is useful when working with a large number of headers or when making quick mass updates.
-
-## Scripts
-
-- **Pre-Scripts**: Execute code before sending the request, like generating tokens or setting dynamic headers.
-- **Post-Scripts**: Execute code after receiving the response, useful for processing or saving the response data.
-
-
-
-To learn more about using scripts visit
-Scripts Documentation
-
-.
\ No newline at end of file
diff --git a/general/api-client/send-api-request/authorization.mdx b/general/api-client/send-api-request/authorization.mdx
new file mode 100644
index 0000000..b816f51
--- /dev/null
+++ b/general/api-client/send-api-request/authorization.mdx
@@ -0,0 +1,111 @@
+---
+title: Authorization
+label: Authorization
+slug: authorization
+description: >-
+ Learn how to set up and use various API Authorization methods in Requestly,
+ including API Key, Bearer Token, and Basic Auth, for secure API interactions.
+seoDescription: >-
+ Learn how to set up and use various API Authorization methods in Requestly,
+ including API Key, Bearer Token, and Basic Auth, for secure API interactions.
+visibility: PUBLIC
+---
+
+Requestly allows you to send authorization data along with your API requests. Authorization data confirms that the sender has permission to access the API.
+
+
+
+## Request Authorization
+
+Authorization details can be configured in the Authorization tab at either the collection level or the individual request level. When authentication is set at the collection level, it applies to all APIs within that collection unless a specific request defines its own authorization settings or selects **“NO-AUTH.”** Requestly automatically inserts the appropriate authorization information into the necessary sections of the request based on the chosen authentication type.
+
+## Steps to Add Authorization
+
+
+
+ Click on any request or collection to begin setting up authorization.
+
+
+
+
+
+
+ 1. Go to the **Authorization** tab.
+ 2. Choose the appropriate authorization type from the dropdown menu.
+
+
+
+
+
+ Each authorization type has specific fields that must be filled. Below are the details for each type:
+
+ #### No Auth
+
+ Requestly won’t send authorization details with a request unless you specify an auth type. If your request doesn’t require authorization, select "No Auth" from the Auth Type dropdown list.
+
+
+
+ #### Inherit Auth from Parent
+
+ Requestly uses the auth applied at the parent level. The inherited properties are populated when the request is sent. This works for API requests and sub-collections.
+
+
+
+ #### API Key
+
+ Requestly allows you to send key-value pairs along with the request data. These can be added to either Headers or Query Params. Select "API Key" from the Auth Type list, then enter your key name and value. Choose "Header" or "Query Params" from the "Add to" dropdown list for their inclusion. Variable storage enhances security.
+
+
+
+ #### Bearer Tokens
+
+ Bearer tokens enable requests to authenticate using an access key such as a JSON Web Token (JWT). Tokens are included in the request header. Select "Bearer Token" from the Auth Type dropdown and enter the token value. For additional security, store the token in a variable and reference it by name.
+
+
+
+ Requestly appends the token value to the text "Bearer" in the required format in the Authorization header.
+
+ #### Basic Auth
+
+ Basic authentication involves sending a verified username and password with your request. Select "Basic Auth" from the Auth Type dropdown. Enter your API username and password in the respective fields. For extra security, store these in variables.
+
+
+
+ In the request headers, the Authorization header passes the API a Base64 encoded string representing the username and password, appended to the text "Basic."
+
+
+
+
+ Click "Send" to ensure that the authorization data is sent along with the API request.
+
+
+
+
+## Variable Support and Export
+
+Requestly supports the use of variables in Authorization Values, allowing flexibility and reuse across multiple requests or collections. Variables can store sensitive data securely and simplify updates when values change. For instance, you can define API tokens or credentials as variables and reference them in authorization fields.
+
+
+
+While authorization data can be exported alongside requests or collections, note that variable values themselves are not exported. This ensures the security of sensitive data and prevents accidental sharing of confidential information. Users need to define variable values locally when importing shared requests or collections.
+
+## What's Next?
+
+
+
+ Store and manage auth tokens securely with variables
+
+
+ Learn how authorization headers are added to requests
+
+
+ Apply authorization to multiple requests at once
+
+
diff --git a/general/api-client/send-api-request/create-requests/configure-request.mdx b/general/api-client/send-api-request/create-requests/configure-request.mdx
new file mode 100644
index 0000000..aa77b0e
--- /dev/null
+++ b/general/api-client/send-api-request/create-requests/configure-request.mdx
@@ -0,0 +1,143 @@
+---
+title: "Configure Request"
+label: "Configure Request"
+slug: "configure-request"
+description: "Learn how to configure HTTP methods, URLs, and send API requests in Requestly."
+visibility: "PUBLIC"
+---
+
+Configuring your API request properly is the first step to successful API testing. This guide covers how to set up HTTP methods, URLs, and send requests effectively.
+
+## HTTP Methods
+
+Requestly supports all standard HTTP methods for API requests:
+
+
+
+ **GET** retrieves data from a server. It's the most common method for fetching resources.
+
+ **Use cases:**
+ - Fetch user data
+ - Get list of items
+ - Retrieve resource details
+
+
+
+ **POST** sends data to create a new resource on the server.
+
+ **Use cases:**
+ - Create new user
+ - Submit form data
+ - Upload content
+
+
+
+ **PUT** updates an existing resource by replacing it entirely.
+
+ **Use cases:**
+ - Update user profile
+ - Replace document
+ - Modify configuration
+
+
+
+ **PATCH** partially updates an existing resource.
+
+ **Use cases:**
+ - Update specific fields
+ - Modify user settings
+ - Change status
+
+
+
+ **DELETE** removes a resource from the server.
+
+ **Use cases:**
+ - Delete user account
+ - Remove item
+ - Clear cache
+
+
+
+ **HEAD** retrieves only the headers of a resource without the body. It's identical to GET but without the response body.
+
+ **Use cases:**
+ - Check if resource exists
+ - Get content length before downloading
+ - Verify last modified date
+
+
+
+ **OPTIONS** retrieves the communication options available for a resource or server.
+
+ **Use cases:**
+ - Check supported HTTP methods
+ - Verify CORS configuration
+ - Discover API capabilities
+
+
+
+## Setting Up Your Request URL
+
+The request URL specifies where your API request should be sent. It consists of several components:
+
+
+
+## Naming Your Request
+
+Give your request a clear, descriptive name to easily identify it later:
+
+**Good naming examples:**
+- `Get User Profile`
+- `Create New Order`
+- `Update Product Inventory`
+- `Delete Customer Account`
+
+**Avoid:**
+- `Test`
+- `Request 1`
+- `API Call`
+
+
+ Use action verbs and specific resource names to make your requests self-documenting. This helps when sharing with team members or revisiting later.
+
+
+## Sending Your Request
+
+Once you've configured your request:
+
+
+
+ Click the **Save** button to preserve your request settings. This allows you to reuse it later without reconfiguring.
+
+
+
+ Press the **Send** button to execute the request. Requestly will display the response in the panel below.
+
+
+
+ Check the response status code, body, and headers to verify the request was successful.
+
+ **Common status codes:**
+ - `200 OK` - Success
+ - `201 Created` - Resource created
+ - `400 Bad Request` - Invalid request
+ - `401 Unauthorized` - Authentication required
+ - `404 Not Found` - Resource doesn't exist
+ - `500 Server Error` - Server-side issue
+
+
+
+## What's Next?
+
+
+
+ Learn how to add query params, path variables, and request body
+
+
+ Set up authentication and custom headers
+
+
+ Configure API Key, Bearer Token, or Basic Auth
+
+
diff --git a/general/api-client/generate-client-code.mdx b/general/api-client/send-api-request/create-requests/generate-client-code.mdx
similarity index 100%
rename from general/api-client/generate-client-code.mdx
rename to general/api-client/send-api-request/create-requests/generate-client-code.mdx
diff --git a/general/api-client/send-api-request/create-requests/overview.mdx b/general/api-client/send-api-request/create-requests/overview.mdx
new file mode 100644
index 0000000..249ed1b
--- /dev/null
+++ b/general/api-client/send-api-request/create-requests/overview.mdx
@@ -0,0 +1,106 @@
+---
+title: "Overview"
+label: "Overview"
+slug: "overview"
+description: "Learn how to create and send API requests in Requestly. Test APIs, configure requests, and view responses without writing code."
+seoTitle: "Create API Requests in Requestly"
+seoDescription: "Complete guide to creating API requests in Requestly. Send HTTP requests, configure parameters, headers, and body data for effective API testing."
+visibility: "PUBLIC"
+---
+
+The API client in Requestly allows you to easily send API requests, without the need for writing code or using a terminal. It lets you test APIs, retrieve data, and explore how they work by simply creating a request, clicking Send, and viewing the response within Requestly.
+
+This feature is perfect for developers testing API endpoints during development, QA engineers validating API responses for edge cases, and support engineers debugging API issues in real-time.
+
+
+
+## Quick Start
+
+Follow these steps to send your first API request:
+
+
+
+ Click the **API Client** link in the left sidebar of the Requestly application, then click the `+ New` button to create a new request and select **Request** from the menu.
+
+
+
+
+ Choose a descriptive title for your request to make it easy to identify later.
+
+
+
+
+ Pick the HTTP method (e.g., GET, POST) and type the URL of the API you want to test.
+
+
+
+
+ Click the **Save** & **Send** button to execute your request.
+
+
+
+
+
+## Understanding the Response
+
+Once you send a request, you'll see the response displayed in the bottom panel with the following information:
+
+### View the Response Body
+
+Check the response body in the **Response Body** section. You can switch between formatted (pretty) and raw views.
+
+
+
+### Check the Response Headers
+
+Review the headers sent back by the server in the **Headers** tab.
+
+
+
+## Next Steps
+
+Now that you understand the basics, explore these guides to master API request creation:
+
+
+
+ Set up HTTP methods, URLs, and send your first request
+
+
+ Add query parameters, path variables, and request body data
+
+
+ Configure headers for authentication and content types
+
+
+ Export your requests as code in multiple programming languages
+
+
\ No newline at end of file
diff --git a/general/api-client/send-api-request/create-requests/parameters-and-body.mdx b/general/api-client/send-api-request/create-requests/parameters-and-body.mdx
new file mode 100644
index 0000000..6cb9928
--- /dev/null
+++ b/general/api-client/send-api-request/create-requests/parameters-and-body.mdx
@@ -0,0 +1,199 @@
+---
+title: "Parameters and Body Data"
+label: "Parameters and Body"
+slug: "parameters-and-body"
+description: "Learn how to add query parameters, path variables, and request body data to your API requests in Requestly."
+visibility: "PUBLIC"
+---
+
+Parameters and request bodies allow you to send data with your API requests. This guide covers query parameters, path variables, and different request body formats.
+
+## Path Variables
+
+Path variables allow you to define dynamic segments in your API URL using the **:variableName** syntax. This is useful for RESTful APIs where resource identifiers are part of the URL path.
+
+For example, if your API endpoint is:
+```
+https://api.example.com/users/:userId/posts/:postId
+```
+
+Requestly automatically detects the path variables (`:userId` and `:postId`) from the URL and displays them in the **Params** tab under **Path Variables**. You can then set values for each variable:
+
+| Key | Value | Description |
+|-----|-------|-------------|
+| userId | 123 | The user's unique identifier |
+| postId | 456 | The post's unique identifier |
+
+When you send the request, Requestly compiles the URL with your provided values:
+```
+https://api.example.com/users/123/posts/456
+```
+
+
+ Path variables are automatically extracted from your URL. Simply type a URL with `:variableName` segments, and they'll appear in the Path Variables table for you to fill in.
+
+
+## Query Parameters
+
+In the **Query Params** section, you can add query parameters as **key-value pairs** to send extra information with the URL. To add more parameters, click on the `+ Add More` button.
+
+Each query parameter consists of:
+
+- **Key**: The parameter name
+- **Value**: The parameter value
+- **Type**: An enum to enforce the value type
+- **Description** (optional): Internal documentation explaining the purpose of the parameter
+
+For example:
+
+- Adding `uid=123` to `https://app.requestly.io/echo` results in: `https://app.requestly.io/echo?uid=123`
+
+
+ The checkboxes next to each parameter let you include or exclude them without deleting them. For instance, if you uncheck a parameter, the final URL will not include it.
+
+
+
+### Bulk Edit Query Parameters
+
+
+You can also manage query parameters using **Bulk Edit**. This allows you to add or update multiple parameters at once in a key:value format.
+
+- Add one parameter per line
+- Separate keys and values using a colon `:`
+- Prefix any line with `//` to disable that parameter
+
+Bulk Edit is useful when working with a large number of query parameters or when making quick mass updates.
+
+**Example:**
+```
+page:1
+limit:50
+sort:desc
+// filter:active
+```
+
+## Request Body
+
+For POST, PUT, or PATCH requests, use the **Body** tab to send data to the server. Requestly supports multiple body formats to accommodate different API requirements.
+
+### Supported Body Types
+
+
+
+ Send raw data as plain **text** or structured **JSON**.
+
+ **When to use:**
+ - Sending JSON data to REST APIs
+ - Posting XML or plain text
+ - Sending custom formatted data
+
+ You can select the language format:
+ - **JSON** – for structured data like API payloads
+ - **Text** – for plain string or unstructured data
+ - **XML** – for XML-based APIs
+ - **HTML** – for HTML content
+
+
+
+ **Example JSON:**
+ ```json
+ {
+ "name": "John Doe",
+ "email": "john@example.com",
+ "age": 30,
+ "active": true
+ }
+ ```
+
+
+
+ Sends data as URL-encoded key-value pairs. This format is commonly used for HTML form submissions.
+
+ **When to use:**
+ - Traditional web form submissions
+ - Simple key-value data
+ - APIs that expect form data
+
+ Each field consists of:
+ - **Key**: Field name
+ - **Value**: Field value
+ - **Description**: Optional documentation
+
+
+
+ **Example:**
+ ```
+ username=johndoe
+ password=secret123
+ remember=true
+ ```
+
+
+
+ Used when uploading files along with form fields. Each field is sent as a separate part of the request body.
+
+ **When to use:**
+ - Uploading images, documents, or files
+ - Sending files with metadata
+ - Form submissions with file attachments
+
+ Each field can be either:
+ - **Text field**: Regular key-value pair
+ - **File field**: File upload with browse button
+
+
+
+ **Example use case:** Uploading a user profile picture with name and bio
+
+
+
+ For GraphQL APIs, use the dedicated GraphQL request type which provides:
+ - Query/Mutation editor with syntax highlighting
+ - Variables panel
+ - Schema introspection
+
+ Learn more in our [GraphQL Request guide](/general/api-client/graphql-request).
+
+
+
+## Autogenerated Headers
+
+Requestly will automatically add certain headers to your requests based on your request body selections. When you add a request body, Requestly automatically sets the appropriate `Content-Type` header:
+
+| Body Type | Content-Type Header |
+|-----------|-------------------|
+| RAW (JSON) | `application/json` |
+| RAW (Text) | `text/plain` |
+| RAW (XML) | `application/xml` |
+| x-www-form-urlencoded | `application/x-www-form-urlencoded` |
+| multipart/form-data | `multipart/form-data` |
+
+
+ You can view and override the autogenerated headers in the Headers tab. These headers are automatically managed by Requestly to ensure your requests are properly formatted.
+
+
+## What's Next?
+
+
+
+ Add authentication and custom headers to your requests
+
+
+ Set up API authentication methods
+
+
+ Make your requests dynamic with variables
+
+
diff --git a/general/api-client/send-api-request/create-requests/request-headers.mdx b/general/api-client/send-api-request/create-requests/request-headers.mdx
new file mode 100644
index 0000000..1f28277
--- /dev/null
+++ b/general/api-client/send-api-request/create-requests/request-headers.mdx
@@ -0,0 +1,113 @@
+---
+title: "Request Headers"
+label: "Request Headers"
+slug: "request-headers"
+description: "Learn how to configure HTTP headers for authentication, content types, and custom metadata in your API requests."
+visibility: "PUBLIC"
+---
+
+HTTP headers are key-value pairs that provide additional information about your request. They're essential for authentication, specifying content types, and sending custom metadata to the API.
+
+## Understanding Headers
+
+Headers serve multiple purposes in HTTP requests:
+
+
+
+ Pass tokens, API keys, or credentials to authenticate with the API
+
+
+ Tell the server what format your data is in (JSON, XML, etc.)
+
+
+ Specify what response format you expect from the server
+
+
+ Send additional information like user agent, tracking IDs, or custom flags
+
+
+
+***
+
+## Adding Headers
+
+The **Headers** tab allows you to add Request Headers in your API request.
+Each header consists of:
+
+- **Key**: The header name (e.g., `Authorization`, `Content-Type`)
+- **Value**: The header value
+- **Description** (optional): Internal documentation to explain the purpose of this header
+
+
+
+
+ The checkboxes next to each header let you include or exclude them without deleting them. This is useful for testing with and without certain headers.
+
+
+### Bulk Edit Headers
+
+You can also manage headers using **Bulk Edit**. This allows you to add or update multiple headers at once in a `key:value` format.
+
+**How to use:**
+1. Click the **Bulk Edit** button in the Headers tab
+2. Add one header per line
+3. Separate keys and values using a colon `:`
+4. Prefix any line with `//` to disable that header
+
+**Example:**
+```
+Content-Type:application/json
+Authorization:Bearer {{token}}
+X-API-Version:v2
+// X-Debug:true
+```
+
+
+ Bulk Edit is especially useful when copying headers from documentation or sharing with team members.
+
+
+## Using Variables in Headers
+
+You can use variables in header values to make them dynamic:
+
+```
+Key: Authorization
+Value: Bearer {{authToken}}
+```
+
+
+ Learn more about using variables in [Variables and Environments](/general/api-client/environments-and-variables).
+
+
+## Header Inheritance
+
+Headers can be inherited from collections, making it easy to apply common headers across multiple requests:
+
+**Collection-Level Headers** → **Request-Level Headers** → **Authorization Tab**
+
+- **Collection-Level Headers**: Set headers at the collection level to apply them to all requests in that collection.
+- **Request-Level Headers**: Request-level headers override collection-level headers with the same key.
+- **Authorization Tab**: Headers set in the Authorization tab are applied in addition to manual headers.
+
+
+ Headers are applied in order, with each level potentially overriding the previous one. Request-level headers have the highest priority.
+
+
+## What's Next?
+
+
+
+ Use the Authorization tab for easier authentication setup
+
+
+ Dynamically generate headers with pre-request scripts
+
+
+ Learn how to use variables in headers
+
+
diff --git a/general/api-client/graphql-request.mdx b/general/api-client/send-api-request/graphql-request.mdx
similarity index 87%
rename from general/api-client/graphql-request.mdx
rename to general/api-client/send-api-request/graphql-request.mdx
index 4d3f6a5..ea787ed 100644
--- a/general/api-client/graphql-request.mdx
+++ b/general/api-client/send-api-request/graphql-request.mdx
@@ -93,3 +93,17 @@ GraphQL requests work over HTTP just like REST, but instead of defining multiple
+
+## What's Next?
+
+
+
+ Secure your GraphQL requests with API keys and tokens
+
+
+ Make your GraphQL queries dynamic with environment variables
+
+
+ Group related GraphQL requests together
+
+
diff --git a/general/api-client/send-api-request/overview.mdx b/general/api-client/send-api-request/overview.mdx
new file mode 100644
index 0000000..f304737
--- /dev/null
+++ b/general/api-client/send-api-request/overview.mdx
@@ -0,0 +1,75 @@
+---
+title: "Overview"
+label: "Overview"
+slug: "overview"
+description: "Learn how to create and send API requests in Requestly. Test APIs, configure requests, and view responses without writing code."
+seoTitle: "Create API Requests in Requestly"
+seoDescription: "Complete guide to creating API requests in Requestly. Send HTTP requests, configure parameters, headers, and body data for effective API testing."
+visibility: "PUBLIC"
+---
+
+Whether you are building and testing your own API or integrating with a third-party API, you can use Requestly to send requests and connect to the APIs you are working with. Your requests can retrieve, create, update, or delete data, and they can include parameters and authorization details.
+
+For example, if you are building a client application such as a mobile or web app for a store, you might send one request to retrieve a list of available products, another request to create a new order with selected product details, and another request to log a customer into their account.
+
+When you send a request, Requestly displays the API server’s response in a clear format so you can inspect, visualize, and troubleshoot it easily.
+
+
+
+---
+
+## Get Started with Sending Requests
+
+If you have not sent a request before, review the [Sending Your First Request](/general/api-client/quick-start) guide before continuing.
+
+Explore the topics below to learn how to send API requests in Requestly:
+
+- To understand the basics of building requests, including selecting HTTP methods, entering URLs, and interpreting response status codes, see [Configure Request](/general/api-client/send-api-request/configure-request).
+
+- To learn how to add query parameters, path variables, and request body data in formats such as JSON, form data, and file uploads, see [Parameters and Body Data](/general/api-client/send-api-request/parameters-and-body).
+
+- If your API requires specific headers or authentication tokens, learn how to configure them in [Request Headers](/general/api-client/send-api-request/request-headers).
+
+- Export requests as code snippets in multiple languages such as JavaScript, Python, and cURL. Learn more in [Generate Client Code](/general/api-client/generate-client-code).
+
+- If your API requires identity verification or access control, review the [Authorization Guide](/general/api-client/authorization).
+
+- Use collections to group related requests for better organization and collaboration. Learn more in [API Collections](/general/api-client/api-collections).
+
+- Variables allow you to reuse data across requests and switch values based on environments such as development, staging, or production. See [Variables and Environments](/general/api-client/environments-and-variables).
+
+- Add JavaScript code to run before sending requests or after receiving responses to automate workflows and extract data. Learn more in [Scripts](/general/api-client/scripts).
+
+- Write automated tests to validate API responses and ensure reliability. See [Tests](/general/api-client/tests).
+
+- Export requests as code snippets in multiple languages such as JavaScript, Python, and cURL. Learn more in [Generate Client Code](/general/api-client/generate-client-code).
+
+In addition to standard HTTP requests, Requestly also supports other formats and protocols such as [GraphQL](/general/api-client/graphql-request). You can also [import from cURL](/general/api-client/import-export/import-from-curl), [migrate from Postman](/general/api-client/import-export/import-from-postman), or [import OpenAPI specifications](/general/api-client/import-export/import-openapi-spec).
+
+---
+
+## What's Next?
+
+
+
+ Start by learning how to configure HTTP methods and URLs
+
+
+ Learn to add query params, path variables, and request body
+
+
+ Follow our complete quick start guide for beginners
+
+
diff --git a/general/api-client/replay-request-from-history.mdx b/general/api-client/send-api-request/replay-request-from-history.mdx
similarity index 78%
rename from general/api-client/replay-request-from-history.mdx
rename to general/api-client/send-api-request/replay-request-from-history.mdx
index 605f318..fc4ab6c 100644
--- a/general/api-client/replay-request-from-history.mdx
+++ b/general/api-client/send-api-request/replay-request-from-history.mdx
@@ -41,3 +41,17 @@ Click the "Clear History" button located at the top of the history sidebar. This
* **Session Constraints:** Responses are cached only within the active browser session. Closing the tab clears all cached responses.
* **Request Limit:** Only the last 20 requests are preserved in the history. Older entries are automatically removed as new requests are made.
+
+## What's Next?
+
+
+
+ Permanently save frequently used requests in collections
+
+
+ Make requests reusable across different environments
+
+
+ Configure authentication for your API requests
+
+
diff --git a/general/http-interceptor/overview.mdx b/general/http-interceptor/overview.mdx
index 3733979..905c530 100644
--- a/general/http-interceptor/overview.mdx
+++ b/general/http-interceptor/overview.mdx
@@ -70,3 +70,19 @@ The **Requestly Desktop App** runs a local proxy server that intercepts HTTP(S)
* [Systemwide proxy](/general/http-interceptor/desktop-app/desktop-app-interception) - Configure Requestly as a systemwide proxy to capture and manipulate traffic across all applications and devices connected to your network.
Once interception is set up, you can explore and debug traffic in the [**network table**](/general/http-interceptor/network-table), [export HAR files](/general/sessions/import-view-har-file), [save sessions](/general/sessions/record-api-sessions), and [create rules](/general/http-rules/rule-types) to simulate responses or rewrite requests in real-time.
+
+***
+
+## What's Next?
+
+
+
+ Start intercepting traffic in your browser
+
+
+ Set up system-wide interception with the desktop app
+
+
+ Learn how to modify intercepted requests and responses
+
+
diff --git a/general/http-rules/overview.mdx b/general/http-rules/overview.mdx
index 11f9f7b..4b0cbc4 100644
--- a/general/http-rules/overview.mdx
+++ b/general/http-rules/overview.mdx
@@ -116,3 +116,19 @@ Distribute rule collections for use across teams or environments. Learn more in
### Download
Export rules for offline use or transfer between systems. Find out how in the [Download guide](/general/http-rules/sharing/download-rules).
+
+***
+
+## What's Next?
+
+
+
+ Explore all available rule types and create your first modification
+
+
+ Start by learning how to modify HTTP headers
+
+
+ Collaborate by sharing rules with your team members
+
+
diff --git a/general/http-rules/rule-types/modify-headers.mdx b/general/http-rules/rule-types/modify-headers.mdx
index ad2f378..e7a1eb9 100644
--- a/general/http-rules/rule-types/modify-headers.mdx
+++ b/general/http-rules/rule-types/modify-headers.mdx
@@ -88,3 +88,19 @@ HTTP(s) Headers are key-value pairs that pass additional information with HTTP(s
+
+***
+
+## What's Next?
+
+
+
+ Learn to modify API request payloads
+
+
+ Simulate different API responses for testing
+
+
+ Keep your rules organized with groups
+
+
diff --git a/general/mock-server/overview.mdx b/general/mock-server/overview.mdx
index 54312ae..65d48ba 100644
--- a/general/mock-server/overview.mdx
+++ b/general/mock-server/overview.mdx
@@ -15,3 +15,19 @@ Requestly’s **File Server** lets you upload and serve files (like JSON, JS, CS
* Replace production JavaScript with development versions to test new features safely
You can use files hosted on the File Server with the [**Redirect Rule**](/general/http-rules/rule-types/redirect-rule) to map live network requests to your hosted files, making it easy to simulate APIs or override resources without changing the actual code.
+
+***
+
+## What's Next?
+
+
+
+ Learn how to create and configure mock APIs
+
+
+ Test your mocks before integrating them
+
+
+ Add dynamic responses with templating
+
+
diff --git a/general/sessions/overview.mdx b/general/sessions/overview.mdx
index 9b1f474..f1f9e61 100644
--- a/general/sessions/overview.mdx
+++ b/general/sessions/overview.mdx
@@ -32,3 +32,18 @@ The Session B
### Create API Sessions in Requestly
Requestly’s Desktop App allows developers to capture and analyze API sessions through methods like the HTTP Interceptor, HAR file import, and .rqly file import. These sessions can be shared with teams by exporting and importing HAR files, making it easy to collaborate, debug issues, and streamline workflows.
+***
+
+## What's Next?
+
+
+
+ Start recording user sessions to capture bugs effectively
+
+
+ Record and replay API interactions for debugging
+
+
+ Analyze existing HAR files in Requestly
+
+
\ No newline at end of file
diff --git a/images/Headers - Create Requests.png b/images/Headers - Create Requests.png
new file mode 100644
index 0000000..bf9153f
Binary files /dev/null and b/images/Headers - Create Requests.png differ
diff --git a/images/url-structure.png b/images/url-structure.png
new file mode 100644
index 0000000..fbc897c
Binary files /dev/null and b/images/url-structure.png differ