Creating a Project - Atlas

Project files view

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.

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:

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.

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.

⌘I