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

# Manage Projects in FusionDesk: A Complete Overview

> Create and manage projects in FusionDesk to coordinate team efforts, assign members, track progress, and deliver work on time with full visibility.

Projects in FusionDesk give your team a single, structured space to plan work, coordinate efforts, and track progress from kickoff to completion. Whether you're running a product launch, an IT infrastructure upgrade, or an ongoing support initiative, projects let you bring together tasks, team members, and deadlines under one roof — so nothing slips through the cracks.

## What Is a Project in FusionDesk?

A project is a container that groups related tasks and team members into one organized workspace. Each project gives you:

* **Tasks** — the individual units of work that need to be completed.
* **Team members** — the people responsible for delivering the work.
* **Due dates** — target completion dates at both the project and task level.
* **Status tracking** — a real-time view of whether the project is planning, active, on hold, or complete.

Projects sit at the top of FusionDesk's work hierarchy. Tasks live inside projects, and tickets can be linked to projects to bridge service requests with planned work.

## Creating a Project

<Steps>
  <Step title="Navigate to Projects">
    From the left sidebar, select **Projects**, then click **New Project** in the top-right corner.
  </Step>

  <Step title="Fill in project details">
    Enter a **Name** and optional **Description** for the project. Set a **Due Date** so the team knows the target completion date.
  </Step>

  <Step title="Add team members">
    In the **Team Members** field, search for and select the colleagues who will work on this project. You can add more members later from the project settings.
  </Step>

  <Step title="Create the project">
    Click **Create Project**. FusionDesk opens the new project board and prompts you to add your first task.
  </Step>
</Steps>

You can also create a project directly via the API:

```bash theme={null}
curl -X POST https://api.fusiondesk.in/v1/projects \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Website Relaunch",
    "description": "End-to-end redesign and launch of the marketing site.",
    "due_date": "2025-09-30",
    "member_ids": ["usr_01", "usr_02"]
  }'
```

A successful response returns the new project object:

```json theme={null}
{
  "id": "proj_abc123",
  "name": "Website Relaunch",
  "description": "End-to-end redesign and launch of the marketing site.",
  "status": "planning",
  "due_date": "2025-09-30",
  "member_ids": ["usr_01", "usr_02"],
  "task_count": 0,
  "created_at": "2025-06-01T09:00:00Z"
}
```

## Project Fields Reference

You can update any project field at any time by opening the project and clicking the **Settings** tab. The table below describes each available field.

| Field            | Description                                                                                                      |
| ---------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Name**         | The display name of the project. Keep it short and descriptive so team members can identify it at a glance.      |
| **Description**  | A longer summary of the project's goals, scope, or context. Supports rich text and inline links.                 |
| **Status**       | The current state of the project: **Planning**, **Active**, **On Hold**, or **Completed**.                       |
| **Due Date**     | The target date for full project completion. Overdue projects are flagged in red on the project list.            |
| **Team Members** | The people assigned to the project. Members receive notifications for project updates and can be assigned tasks. |

## Retrieving and Updating Projects

To fetch a list of all your projects, send a `GET` request to the projects endpoint:

```bash theme={null}
curl https://api.fusiondesk.in/v1/projects \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

To update a specific project — for example, to change its status to `completed`:

```bash theme={null}
curl -X PUT https://api.fusiondesk.in/v1/projects/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "completed"
  }'
```

## Archiving and Deleting Projects

When a project is complete, you have two options for winding it down:

**Archive a project** when you want to preserve the record but remove it from your active project list. Archived projects remain searchable and fully readable, but no new tasks can be added.

1. Open the project and click **Settings**.
2. Scroll to the **Danger Zone** section and click **Archive Project**.
3. Confirm the action. The project moves to the **Archived** tab in the Projects list.

**Delete a project** when you want to permanently remove it and all its tasks. This action cannot be undone.

<Warning>
  Deleting a project permanently removes all tasks, comments, attachments, and activity history associated with it. Linked tickets are not deleted but will lose their project association. Archive instead of delete whenever possible.
</Warning>

1. Open the project and click **Settings**.
2. In the **Danger Zone** section, click **Delete Project**.
3. Type the project name to confirm, then click **Delete**.

You can also delete a project via the API:

```bash theme={null}
curl -X DELETE https://api.fusiondesk.in/v1/projects/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

## Linking Tickets to a Project

FusionDesk lets you connect help desk tickets directly to a project, giving you full context when service requests are part of a larger initiative.

<Steps>
  <Step title="Open the ticket">
    Navigate to **Help Desk** and open the ticket you want to link.
  </Step>

  <Step title="Find the Project field">
    In the ticket detail panel on the right, locate the **Project** field under the **Details** section.
  </Step>

  <Step title="Select a project">
    Click the **Project** field, search for the target project by name, and select it. The ticket now appears in the project's **Linked Tickets** tab.
  </Step>
</Steps>

You can also link tickets from within a project. Open the project, go to the **Linked Tickets** tab, and click **Link Ticket** to search and attach existing tickets.

<Tip>
  FusionDesk includes project templates for common workflows such as IT onboarding, product launches, and incident response. When creating a new project, click **Use a Template** instead of starting from scratch to pre-populate tasks and recommended team roles. You can customise any template before saving.
</Tip>