Overview

Organize your validation work into logical projects. Each project groups related URLs, validations, and monitoring configurations — ideal for managing multiple clients or sites.

How It Works

1. Create a project with a name and optional description
2. Assign validations to the project
3. All project data (history, scores, monitoring) is grouped
4. Team viewers can be scoped to specific projects
5. Export and reporting work at the project level

Tier Availability

| Tier | Max Projects |
|——|————-|
| Free | — |
| Pro | 5 |
| Agency | 30 |
| Enterprise | 100 |

Related Features

– Viewer Project Scoping: Restrict team access by project
– Export CSV/PDF: Export project data
– Validation History: Filtered by project

Mini-Tutorial

Step 1: Create a New Project

From the dashboard, click “Projects” > “New Project.” Enter a name and optional description.

Step 2: Assign Validations

When validating URLs (via UI or API), select which project they belong to. This organizes related URLs together.

Step 3: Configure Project Settings

Optional: Add project-specific metadata like client name, notes, or budget tracking tags.

Step 4: Team Access

When inviting team members, assign them as Viewers and scope their access to specific projects. They’ll only see those projects.

Step 5: Monitor Project Health

Each project has its own SiteHealthScore and trends dashboard. Watch your project metrics improve over time.

Technical Details

Create Project

POST /api/v1/projects
{
  "name": "Acme Corp Website",
  "description": "Main e-commerce site validation project",
  "metadata": {
    "client_id": "client_123",
    "url": "https://acme.com"
  }
}

Response:

{
  "id": "proj_abc123",
  "name": "Acme Corp Website",
  "description": "Main e-commerce site validation project",
  "created_at": "2025-03-22T10:00:00Z",
  "owner_id": "user_xyz",
  "stats": {
    "total_validations": 0,
    "current_score": null
  }
}

List Projects

GET /api/v1/projects?page=1&per_page=10

Response:

{
  "projects": [
    {
      "id": "proj_abc123",
      "name": "Acme Corp Website",
      "created_at": "2025-03-22T10:00:00Z",
      "last_updated": "2025-03-22T14:30:00Z",
      "stats": {
        "total_validations": 156,
        "current_score": 81,
        "valid_count": 148,
        "invalid_count": 8
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total": 5
  }
}

Delete Project

DELETE /api/v1/projects/proj_abc123

Note: Deletion is permanent. All associated validations are archived but inaccessible.

References

– Project Management Best Practices
– REST API Resource Design
– CRUD Operations Pattern
– ValidGraph Projects API