> For the complete documentation index, see [llms.txt](https://docs.qyrus.com/api-testing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qyrus.com/api-testing/getting-started/project-creation-for-api.md).

# Project Creation and Management

This guide explains how to access the API Testing dashboard and create, update, clone, delete, and share projects.

## Table of Contents

* [Access the project dashboard](#access-the-project-dashboard)
* [Create a project](#create-a-project)
* [Manage an existing project](#manage-an-existing-project)
* [Edit a project](#edit-a-project)
* [Clone a project](#clone-a-project)
* [Delete a project](#delete-a-project)
* [Copy a project link to share](#copy-a-project-link-to-share)
* [Input checks and troubleshooting](#input-checks-and-troubleshooting)

## Access the project dashboard

1. Select **API Testing** from the Qyrus services menu.
2. The dashboard displays **Recent Projects** and **All Projects**.
3. Use **Quick search**, **Created By**, or **Sort By** to find a project.

Each project displays counts for its suites, scripts, and workflows, along with its owner and last-updated information.

![API Testing project dashboard](https://2173886669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrWgLy70uByJZz2Zz3InN%2Fuploads%2Fgit-blob-fbf092d6ad981d26cb8edfeaf2ccac198e5433e2%2FProject-Dashboard.png?alt=media)

If no projects are available, select **Create Project** to create your first project. If you expected an existing project, clear the search and filters and check that you have access to it.

## Create a project

1. Select the **Create Project** tile on the dashboard. You can also use the **+** button in the top navigation.
2. In the **Create Project** dialog, complete the following fields:
   * **Select Project Icon** (required): Keep the default icon or select the edit icon to choose another one.
   * **Project Name** (required): Enter a name of up to 60 characters.
   * **Key** (required): Enter a unique project key of up to 5 characters.
   * **Description** (optional): Enter a description of up to 255 characters.
3. Select **Create Project**. The button becomes available after all required fields contain valid values.

![Create Project dialog](https://2173886669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrWgLy70uByJZz2Zz3InN%2Fuploads%2Fgit-blob-6ebf4e4700f49c404b23c72e446738cb4f0d0515%2FCreate-Project.png?alt=media)

## Manage an existing project

In **All Projects**, locate the project and select its three-dot menu. The available actions are:

* **Edit**
* **Project Details**
* **Clone Projects**
* **Delete**
* **Copy link to share**

![Project actions menu](https://2173886669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrWgLy70uByJZz2Zz3InN%2Fuploads%2Fgit-blob-872aa504ddbb01ee0e9d021c22b5b88f1b6c33d9%2FProject-Actions.png?alt=media)

## Edit a project

1. Open the project's three-dot menu and select **Edit**.
2. Update the project icon, name, or description. The project key is displayed but cannot be changed.
3. Select **Update Project** to save the changes.

![Update Project dialog](https://2173886669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrWgLy70uByJZz2Zz3InN%2Fuploads%2Fgit-blob-ff625ae7cc359163bdaea2c1d0e9443859addf7f%2FUpdate-Project.png?alt=media)

## Clone a project

1. Open the source project's three-dot menu and select **Clone Projects**.
2. Enter a unique **Key** of up to 5 characters for the cloned project.
3. Select **Clone Project**.

![Clone Project dialog](https://2173886669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrWgLy70uByJZz2Zz3InN%2Fuploads%2Fgit-blob-8b5b05fe618658956360d7b91aadb417b71fa907%2FClone-Project.png?alt=media)

## Delete a project

> **Warning:** Deleting a project removes all data associated with it and cannot be undone.

1. Open the project's three-dot menu and select **Delete**.
2. Enter the project name exactly as shown to confirm the action.
3. Select **Delete Project**.

![Delete Project confirmation dialog](https://2173886669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrWgLy70uByJZz2Zz3InN%2Fuploads%2Fgit-blob-e9f4b5a42fd25e6729a5743b3f1d2de92dc8247a%2FDelete-Project-Confirmation.png?alt=media)

## Copy a project link to share

1. Open the project's three-dot menu.
2. Select **Copy link to share**. The project URL is copied to your clipboard.
3. Share the copied URL with users who have permission to access the project.

Example project link: <https://stg.qyrus.com/api-testing/dashboard/P3088>

When opening a copied link in another browser, sign in with an account that has access to the project. Copying the link does not grant project access.

## Input checks and troubleshooting

* If creation or editing cannot be saved, check the required project name and its 60-character limit, and keep the description within 255 characters.
* When creating or cloning a project, use a unique key of up to 5 characters. Choose a different key if it is already in use.
* To confirm deletion, enter the project name exactly as displayed. Review the selected project before confirming this irreversible action.

Continue to [Project Settings](/api-testing/project-setup/project-set-up.md) to manage the project name, icon, and deletion options.