Quick Start

Make your first API call to Controlinfra in under 5 minutes.

1. Get an API Token

You have two options:

Option A: Login with Email

curl -X POST https://api.controlinfra.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com", "password": "your-password"}'

Save the token from the response.

Option B: Create a CLI Token (Recommended for Automation)

1. Log in to the Controlinfra Dashboard
2. Go to Settings > API Tokens
3. Click Create Token
4. Select the scopes you need
5. Copy the generated ci_ token

See CLI Tokens for details.

2. View Your Dashboard

export TOKEN="your-token-here"

curl -H "Authorization: Bearer $TOKEN" \
  https://api.controlinfra.com/api/scans/dashboard

This returns a summary of your scans, drifts, and active repositories.

3. List Your Repository Configs

curl -H "Authorization: Bearer $TOKEN" \
  https://api.controlinfra.com/api/repo-configs/

4. Trigger a Scan

Pick a repository config ID from the previous step:

curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://api.controlinfra.com/api/scans/trigger/REPO_CONFIG_ID

5. Check Scan Status

curl -H "Authorization: Bearer $TOKEN" \
  https://api.controlinfra.com/api/scans/SCAN_ID

6. View Detected Drifts

Once the scan completes:

curl -H "Authorization: Bearer $TOKEN" \
  https://api.controlinfra.com/api/scans/SCAN_ID/details

Or list all drifts:

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.controlinfra.com/api/drifts/?status=detected"

7. Generate a Fix

For a specific drift:

curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://api.controlinfra.com/api/drifts/DRIFT_ID/generate-fix

8. Create a Pull Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://api.controlinfra.com/api/drifts/DRIFT_ID/create-pr

Next Steps

• Authentication — Learn about all auth methods
• CLI Tokens — Set up tokens for CI/CD pipelines
• Rate Limiting — Understand rate limits for automation
• Runners — Set up self-hosted scan runners