Projects

Projects are containers for your test plans. Each project represents a web application you want to test and can have its own webhook configuration for notifications.

Creating a Project

1. Go to Dashboard → Projects
2. Click Create Project
3. Fill in the details:

Project URL

When you set a project URL, it automatically gets prepended to your test plan prompts:

Project URL: https://myapp.com

Test Plan: "Go to the pricing page and verify the free tier is listed"

Effective prompt: "This test run is for https://myapp.com.

Go to the pricing page and verify the free tier is listed"

Webhook Configuration

Configure webhooks to receive notifications when tests complete.

Setting Up a Webhook

1. Edit your project
2. Enter your Webhook URL (e.g., https://your-server.com/webhook)
3. Save the project - a Webhook Secret is automatically generated

Webhook Security

Your webhook secret is used to sign payloads. Always verify signatures before processing webhooks. See Webhooks for verification examples.

Project Organization Tips

By Environment

Create separate projects for different environments:

• MyApp - Production
• MyApp - Staging
• MyApp - Development

By Feature Area

For large applications, organize by feature:

• MyApp - Authentication
• MyApp - Checkout
• MyApp - Dashboard

API Access

Projects can be accessed via the API using projectId:

# Run all test plans for a project
curl -X POST https://test-lab.ai/api/v1/run \
  -H "Authorization: Bearer tl_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"projectId": YOUR_PROJECT_ID}'

See API Reference for more details.

Metrics

Each project tracks:

• Test Plan Count - Number of test plans in the project
• Run Count - Total test executions
• Build Count - Unique build IDs (for CI integration)

Next Steps