{
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "layouts": {
    "lg": [
      { "i": "widget-1", "x": 0, "y": 0, "w": 6, "h": 4 },
      { "i": "widget-2", "x": 6, "y": 0, "w": 6, "h": 4 }
    ],
    "md": [...],
    "sm": [...],
    "xs": [...],
    "xxs": [...]
  },
  "widgets": [
    {
      "id": "widget-1",
      "name": "Carbon Footprint by Scope",
      "type": "bar_chart",
      "config": { ... }
    }
  ],
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-06-20T14:45:00Z"
}

{
  "metrics": [
    {
      "id": "metric-1",
      "name": "Total Emissions",
      "category": "emissions",
      "filters": [
        { "type": "scope", "field": "scope", "value": "1" }
      ],
      "aggregation": {
        "organizations": [
          {
            "id": "org-uuid",
            "facilities": ["facility-uuid-1", "facility-uuid-2"]
          }
        ]
      },
      "target": { "percentage": -15.0 }
    }
  ],
  "periodicity": "monthly",
  "periods": [
    { "start_date": "2024-01-01", "end_date": "2024-12-31" }
  ],
  "unit": "tCO2e"
}

{
  "id": "comment-uuid-001",
  "project_id": "project-uuid",
  "widget_id": "widget-1",
  "comment": "Scope 1 emissions increased due to new facility commissioning in Q3",
  "created_by": "user-uuid",
  "first_name": "Maria",
  "last_name": "Garcia",
  "created_at": "2024-07-15T11:20:00Z",
  "updated_at": null
}

import requests
import os

headers = {
    "x-api-key": os.environ["DCYCLE_API_KEY"],
    "x-organization-id": os.environ["DCYCLE_ORG_ID"],
}

project_id = "your-project-uuid"

# Create an empty dashboard
requests.post(
    "https://api.dcycle.io/v1/dashboard/create",
    headers=headers,
    json={"project_id": project_id}
)

# Add a carbon footprint widget from template
widget = requests.post(
    f"https://api.dcycle.io/v1/dashboard/{project_id}/template",
    headers=headers,
    params={"lang": "en"},
    json={"template_type": "carbonFootprint"}
).json()

print(f"Widget created: {widget['id']}")

result = requests.post(
    "https://api.dcycle.io/v1/widget/calculate",
    headers=headers,
    json={
        "metrics": [{
            "id": "scope-1",
            "category": "emissions",
            "filters": [{"type": "scope", "field": "scope", "value": "1"}],
            "aggregation": {
                "organizations": [{"id": "your-org-uuid"}]
            }
        }],
        "periodicity": "monthly",
        "periods": [
            {"start_date": "2024-01-01", "end_date": "2024-12-31"}
        ],
        "unit": "tCO2e"
    }
).json()

for data_point in result:
    print(data_point)

comment = requests.post(
    f"https://api.dcycle.io/v1/dashboard_comments/{project_id}",
    headers=headers,
    json={
        "widget_id": "widget-1",
        "comment": "Q3 spike is due to new facility in Valencia",
        "created_by": "your-user-uuid"
    }
).json()

print(f"Comment added: {comment['id']}")