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

# Creating a Project

> Add your Project to Atlas to begin analyzing and testing your PCB in Atlas.

<Frame>
  <img src="https://mintcdn.com/sirius-arena-ai/6Qv9zML3omSsGf8m/creating-a-project.png?fit=max&auto=format&n=6Qv9zML3omSsGf8m&q=85&s=06546b4f12b0b894950e56f9112280ce" alt="Project files view" width="3016" height="1526" data-path="creating-a-project.png" />
</Frame>

## 1. Create the project

Start by creating the project shell. This gives you a `project_id` you'll use to attach files in the next step.

```bash theme={null}
curl -X POST "$ATLAS_URL/api/v1/projects" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "IMU Sensor",
    "description": "Inertial measurement unit reference design"
  }'
```

Save the `project_id` from the response:

```bash theme={null}
export PROJECT_ID="<project_id from response>"
```

**Field reference:**

| Field         | Required | Description                            |
| ------------- | -------- | -------------------------------------- |
| `title`       | Yes      | Display name for the project           |
| `description` | No       | Free-text description                  |
| `system_uuid` | No       | Link the project to an existing system |
| `group_ids`   | No       | Scope the project to specific groups   |
| `metadata`    | No       | Free-form JSON metadata                |

## 2. Add files to the project

Register the design files that belong to this project — schematics, BOMs, netlists, design docs, telemetry. Each file must already be in S3. Provide its S3 URL and Atlas registers it as a file object on the project.

```bash theme={null}
curl -X POST "$ATLAS_URL/api/v1/projects/$PROJECT_ID/upload_file" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "s3_uri": "s3://your-bucket/imu-sensor/Schematic.PDF"
  }'
```

Repeat the request for each file you want to attach.