Integrations
CI/CD Integration
Integrate AegisRunner with your CI/CD pipeline for automated testing on every deployment.
CI/CD Integration
Integrate AegisRunner into your CI/CD pipelines to automatically run tests, trigger crawls, and gate deployments.
Availability: CI/CD integration is available on Starter plans and above.
Overview
One endpoint supports two workflows:
| Workflow | When | What happens |
|---|---|---|
| PR Testing | Pull requests | Runs existing tests, returns pass/fail to block merge |
| Deploy Crawl | After deploy | Crawls site, generates fresh AI tests |
Token Management
Create tokens from Project → Integrations → CI/CD. Tokens are SHA-256 hashed, shown once at creation.
Trigger Endpoint
POST /api/v1/ci/trigger\nAuthorization: Bearer aegis_YOUR_TOKENOptions
| Field | Type | Description |
|---|---|---|
crawl | boolean | Full site crawl before tests |
baseUrl | string | Preview URL (domain must match project) |
maxPages | int | Max pages to crawl |
maxDepth | int | Max link depth |
device | string | desktop or mobile |
fillForms | boolean | Fill forms during crawl |
respectRobots | boolean | Respect robots.txt |
suiteIds | string[] | Specific suites to run |
selectionStrategy | string | Smart selection: all, recent-failures, high-priority, smoke, changed-routes, regression-risk |
Examples
Run Tests (PR)
curl -X POST /api/v1/ci/trigger -H "Authorization: Bearer aegis_..." -d "{}"Crawl + Regenerate (Deploy)
curl -X POST /api/v1/ci/trigger -H "Authorization: Bearer aegis_..." -d "{\"crawl\": true}"Preview URL
curl -X POST /api/v1/ci/trigger -d "{\"crawl\": true, \"baseUrl\": \"https://preview.example.com\"}"Config inheritance: When crawl options are omitted, settings from the last crawl are used automatically.