API Reference

The Weaver API gives you programmatic access to project intelligence, document analysis, schedule risk scoring, and integration sync. All endpoints return JSON and follow REST conventions.

Authentication

All API requests must include your API key in the Authorization header as a Bearer token. You can generate and manage API keys in your account settings under Settings → API Keys.

# Example authenticated request curl https://api.helloweaver.com/v1/projects \ -H "Authorization: Bearer wvr_live_your_key" \ -H "Content-Type: application/json"

Quick Start

Get up and running with the Weaver API in under 5 minutes.

1. 1

   Generate an API key

   Go to Settings → API Keys in your Weaver account and create a new key. Copy it somewhere safe — you won't be able to see it again.

2. 2

   Make your first request

   List your projects to confirm authentication is working:

   GET /v1/projectsCopy

   curl https://api.helloweaver.com/v1/projects \ -H "Authorization: Bearer wvr_live_your_key"

3. 3

   Upload and analyze a document

   Upload a project schedule or contract to extract AI insights:

   POST /v1/documents/uploadCopy

   curl -X POST https://api.helloweaver.com/v1/documents/upload \ -H "Authorization: Bearer wvr_live_your_key" \ -F "file=@schedule.pdf" \ -F "project_id=proj_abc123" \ -F "analyze=true"

4. 4

   Set up a webhook

   Subscribe to events so your system is notified when analysis completes or risk scores change.

SDKs & Libraries

Official SDKs handle authentication, retries, and response parsing automatically.

npm install @weaver/api

Error Handling

The API uses conventional HTTP status codes. Errors return a JSON body with a code, message, and optional details.

{ "error": { "code": "invalid_request", "message": "The field 'project_id' is required.", "details": { "field": "project_id", "constraint": "required" } } }

Rate Limits

Rate limits are applied per API key, per minute. When a limit is exceeded, the API returns a 429 with a Retry-After header.

List projects

{ "data": [ { "id": "proj_abc123", "name": "Terminal 4 Expansion", "status": "active", "risk_score": 72, "created_at": "2026-03-01T09:00:00Z", "updated_at": "2026-07-06T14:22:00Z" } ], "pagination": { "cursor": "cur_xyz789", "has_more": true, "total": 47 } }

Upload document

{ "id": "doc_7f2a91", "project_id": "proj_abc123", "filename": "schedule_rev3.pdf", "document_type": "schedule", "size_bytes": 2048420, "status": "analyzing", "analysis_id": "anlys_9b3c12", "uploaded_at": "2026-07-07T10:31:00Z" }

Analyze schedule

{ "document_id": "doc_7f2a91", "baseline_id": "doc_3a1b00", "options": { "detect_logic_errors": true, "flag_missing_predecessors": true, "check_resource_overallocation": true } }

{ "analysis_id": "anlys_9b3c12", "status": "queued", "estimated_duration_s": 45, "webhook_event": "schedule.analysis.completed" }

Score project

{ "project_id": "proj_abc123", "score": 72, "risk_level": "high", "drivers": [ { "factor": "schedule_float", "weight": 0.35, "score": 81 }, { "factor": "open_rfis", "weight": 0.25, "score": 64 }, { "factor": "resource_loading", "weight": 0.20, "score": 55 }, { "factor": "weather_forecast", "weight": 0.20, "score": 70 } ], "scored_at": "2026-07-07T10:31:00Z" }

Create webhook

{ "url": "https://your-app.com/webhooks/weaver", "events": [ "schedule.analysis.completed", "risk.score.changed", "risk.flag.created" ], "secret": "your_signing_secret" }

Changelog