Projects

Projects are the core organizational units of EdgeWrap. Each project maps to your upstream origin services and holds its own WAF policies, caching rules, API keys, and observability logs.

Dashboard Setup & Configuration

You can create, update, and manage your projects directly inside the EdgeWrap Dashboard:

1. Navigate to your dashboard at https://app.edgewrap.pro.
2. Click the New Project button on the projects list page.
3. Under settings, you can edit your project name, description, and primary origin URLs.
4. Toggle individual security and performance features (such as WAF, Caching, DDoS Protection, Bot Detection, or Secret Shield) for the project.
5. To delete a project, scroll to the bottom of the project settings tab and click Delete Project. Project deletion schedules a 30-day purge window.

Create a Project via API

curl -X POST https://server.edgewrap.pro/v1/projects \
  -H "Authorization: Bearer <your_session_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Payment API",
    "description": "Stripe payment integration layer",
    "originUrl": "https://payments.internal.mycompany.com"
  }'

{
  "success": true,
  "data": {
    "id": "prj_abc123def456",
    "slug": "payment-api",
    "name": "Payment API",
    "description": "Stripe payment integration layer",
    "originUrl": "https://payments.internal.mycompany.com",
    "edgeUrl": "https://payment-api-def456.edgewrap.pro",
    "status": "active",
    "wafEnabled": false,
    "cacheEnabled": false,
    "ddosProtectionEnabled": false,
    "botDetectionEnabled": false,
    "secretShieldEnabled": false,
    "createdAt": "2026-06-16T10:00:00.000Z"
  }
}

Update a Project via API

Any subset of the following settings can be updated in a single PATCH request.

curl -X PATCH https://server.edgewrap.pro/v1/projects/prj_abc123def456 \
  -H "Authorization: Bearer <your_session_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "wafEnabled": true,
    "cacheEnabled": true,
    "ddosProtectionEnabled": true,
    "botDetectionEnabled": true,
    "secretShieldEnabled": true
  }'

Project Status Types

Delete & Restore via API

Deleting a project transitions its status to pending_purge. After 30 days, background jobs permanently delete all configuration and logs. You can cancel deletion within this grace window.

# Schedule for deletion
curl -X DELETE https://server.edgewrap.pro/v1/projects/prj_abc123def456 \
  -H "Authorization: Bearer <your_session_token>"

# Cancel within the 30-day window
curl -X POST https://server.edgewrap.pro/v1/projects/prj_abc123def456/restore \
  -H "Authorization: Bearer <your_session_token>"

Plan Limits