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

# Creating a Test Run Report

> Record a verification campaign and generate an AI analysis report.

<Frame>
  <img src="https://mintcdn.com/nova-arena-ai/QLYGKsZPO6EMCCJF/test-run-report.png?fit=max&auto=format&n=QLYGKsZPO6EMCCJF&q=85&s=39e9879244e414a28b5ae434531e2425" alt="Test run analysis report" width="3092" height="1751" data-path="test-run-report.png" />
</Frame>

## 1. Create a test run

```bash theme={null}
curl -X POST "https://nokia.atlas.arenaphysica.com/api/v1/test-runs" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Motor Controller Acceptance Test",
    "system_id": "<system_id>"
  }'
```

Save the `uuid` from the response:

```bash theme={null}
export RUN_ID="<uuid from response>"
```

## 2. Register test data

Attach data files to the test run. Each file must already be in S3. Provide the S3 URL, file name, and size in bytes.

```bash theme={null}
curl -X POST "https://nokia.atlas.arenaphysica.com/api/v1/test-runs/$RUN_ID/data" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "test_log.csv",
    "s3_url": "s3://your-bucket/test-data/test_log.csv",
    "file_size": 204800
  }'
```

You can register multiple data files in separate requests.

## 3. Generate an analysis report

Once data is registered, trigger Atlas to analyze it:

```bash theme={null}
curl -X POST "https://nokia.atlas.arenaphysica.com/api/v1/test-runs/$RUN_ID/reports" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Acceptance Test Analysis"}'
```

Save the `uuid` from the response:

```bash theme={null}
export REPORT_ID="<uuid from response>"
```

## 4. Fetch the report

```bash theme={null}
curl "https://nokia.atlas.arenaphysica.com/api/v1/test-runs/$RUN_ID/reports/$REPORT_ID" \
  -H "Authorization: Bearer $ATLAS_TOKEN"
```

Report generation runs asynchronously. Poll the endpoint until the report content is populated.