> ## Documentation Index
> Fetch the complete documentation index at: https://docs.requestly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Collections

> Organise and manage APIs with Requestly’s API Collections. Learn to create, rename, delete collections, use folders, and explore collection variables.

***

API Collections help developers and QA teams organize and group APIs for better management. They also offer additional features such as detailed API information and collection-specific variables. Let's explore how to create, manage, and utilize API Collections and their features.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/m8wdY3oSGRc" />

## Create API Collection

**Step 1:** Click **+ New** and select **Collection**.

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---1-4.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=a3246f3b8e8c475ac13efa73ba99d45b" align="center" fullwidth="false" className="dark:hidden" width="2400" height="1400" data-path="images/API-Collection---1-4.png" />

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---1-3.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=d47cbb4f61d25a959c8d3082fc1d297a" align="center" fullwidth="false" className="hidden dark:block" width="2400" height="1400" data-path="images/API-Collection---1-3.png" />

**Step 2:** Provide a descriptive name (e.g., “User Management APIs”) and hit **Enter**.

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---3.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=fd10d9a3a973b3aa82be7f4a9eb625fb" align="center" fullwidth="false" className="dark:hidden" width="2400" height="1400" data-path="images/API-Collection---3.png" />

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---3-2.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=050e458588f67fe0c1bd42f6c56246f7" align="center" fullwidth="false" className="hidden dark:block" width="2400" height="1400" data-path="images/API-Collection---3-2.png" />

Once a collection is created, you can add requests and sub-collections.

## Rename API Collection

**Step 1:** Click the **More** icon next to the collection name you want to rename, then select Rename.

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---2-4.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=4e30b4e0eca75cb9c4d8f4d1eca58aed" align="center" fullwidth="false" className="dark:hidden" width="2400" height="1400" data-path="images/API-Collection---2-4.png" />

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---2-2.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=08b9cc2720e8ccd95d1fdf51b074c28e" align="center" fullwidth="false" className="hidden dark:block" width="2400" height="1400" data-path="images/API-Collection---2-2.png" />

**Step 2:** An inline input field will appear with the current name. Update the name and press **Enter** to save the changes.

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---3-4.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=7713865383d136e4c300a4b074b6443d" align="center" fullwidth="false" className="dark:hidden" width="2400" height="1400" data-path="images/API-Collection---3-4.png" />

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---3-3.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=726cd07c5eec338a33d83a6c1f682e45" align="center" fullwidth="false" className="hidden dark:block" width="2400" height="1400" data-path="images/API-Collection---3-3.png" />

## Delete API Collection

**Step 1:** Click the **More** icon next to the collection name and select `Delete`.

**Step 2:** Confirm the action in the Delete Collection prompt.

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---7.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=0a59f8ea0e579e5f8a6a49e929d68c27" alt="Confirm Delete Collection prompt with buttons labeled Cancel and Delete Collection" align="center" fullwidth="true" lightAlt="Confirm Delete Collection prompt with buttons labeled Cancel and Delete Collection" darkAlt="Confirm Delete Collection prompt with buttons labeled Cancel and Delete Collection" className="dark:hidden" width="2400" height="1416" data-path="images/API-Collection---7.png" />

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---7-1.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=4edb761f05471d8452343d5e019098c6" alt="Confirm Delete Collection prompt with buttons labeled Cancel and Delete Collection" align="center" fullwidth="true" lightAlt="Confirm Delete Collection prompt with buttons labeled Cancel and Delete Collection" darkAlt="Confirm Delete Collection prompt with buttons labeled Cancel and Delete Collection" className="hidden dark:block" width="2400" height="1416" data-path="images/API-Collection---7-1.png" />

<Warning>
  Make sure you are deleting the correct collection. Deleted collections are permanently removed and cannot be recovered.
</Warning>

## Create Folders

Folders allow you to create sub-groups within a collection. They can have their own collection variables and share all the features of a collection. Folders(Sub-Collections) inherit all the collection variables from its parent. However, You can override parent-collection variables by defining a collection variable inside the sub-collection.

**Step 1:** Click on the Add Folder icon next to the collection name.

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---5.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=311cafa8c5a9f08bd929b520fe09719d" align="center" fullwidth="false" className="dark:hidden" width="2400" height="1400" data-path="images/API-Collection---5.png" />

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---5-1.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=cb8e9e41a6549645f025571a9c75ad6c" align="center" fullwidth="false" className="hidden dark:block" width="2400" height="1400" data-path="images/API-Collection---5-1.png" />

**Step 2:** Provide a descriptive name (e.g., “Login APIs”) and press **Enter**.

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---6.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=4fa70bde7083ffe2779faa3430e67751" align="center" fullwidth="false" className="dark:hidden" width="2400" height="1400" data-path="images/API-Collection---6.png" />

<img src="https://mintcdn.com/requestly/71zp2E4ip50ZwDis/images/API-Collection---6-1.png?fit=max&auto=format&n=71zp2E4ip50ZwDis&q=85&s=6a8eb7b5aa47023fe6217f5cd5131412" align="center" fullwidth="false" className="hidden dark:block" width="2400" height="1400" data-path="images/API-Collection---6-1.png" />

## Collection Variables

Collections include a **collection variables** feature that allows you to define and manage reusable values specific to the collection. Collection Variables are defined as key-value pairs that work as the base set of variables for collections. They can be used in API definitions with double curly braces `{{collection_variable}}`

Learn more about this feature on the [Variables](/api-client/environments-and-variables) page.

## Collection Runner

The **Collection Runner** allows you to execute multiple API requests from a collection sequentially in a single run. It helps automate request workflows such as *login → create resource → fetch resource* while utilizing existing variables and scripting capabilities.

Use it to configure iterations, delays, and environments, view detailed run results, debug failed requests, and export summaries for analysis.

Learn more about this feature on the [**Collection Runner**](https://docs.requestly.com/api-client/collection-runner) page.
