Use the Archera Partner API to programmatically onboard customers and set up Azure cloud integration.

## Prerequisites:

- Partner API key and partner organization ID

- Contact your Archera representative if you don’t have these credentials

- Customer must have Azure subscription with billing access

## Base URL: `https://api.archera.ai/v2`

## Authentication: Include `x-api-key: YOUR_PARTNER_API_KEY` header in all requests.

---

### Step 1: Register the customer organization

```bash
curl -X POST \
  -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{\n    "org_name": "Acme Corp",\n    "org_email": "admin@acmecorp.com",\n    "user_emails": ["admin@acmecorp.com"],\n    "user_names": ["Admin User"]\n  }' \
  https://api.archera.ai/v2/partners/{partner_org_id}/orgs
```

**Save from response:** `child_org_id`

---

### Step 2: Generate Azure authentication URL

```bash
curl -X POST \
  -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{\n    "tenant_id": "customer-azure-tenant-id",\n    "subscription_id": "customer-subscription-id"\n  }' \
  https://api.archera.ai/v2/org/{child_org_id}/partners/onboarding/azure/auth-url
```

**Send the returned URL to your customer** to complete Azure authentication.

---

### Step 3: Verify Azure integration

After customer completes authentication:

```bash
curl -X POST \
  -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  https://api.archera.ai/v2/org/{child_org_id}/partners/onboarding/azure/verify
```

**Check response:** All validations should return successful status.

---

### What You Can Do

The Archera Partner API enables you to:

- **Register customer organizations** under your partner account
- **Set up Azure cloud integration** using OAuth authentication
- **Verify integration status** and data collection
- **Access commitment recommendations** for your customers
- **Execute purchases** on behalf of customers

This allows you to build Archera’s cost optimization capabilities directly into your platform.