Forensics

As-Planned vs. As-Built Comparison (Async)

Submit async as-planned vs. as-built comparison for large schedules. Poll GET /api/v1/jobs/{job_id}.

post/api/v1/forensics/as-planned-vs-as-built/async

Request

  • Base URL: https://api.bellatorsi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.bellatorsi.com/api/v1/forensics/as-planned-vs-as-built/async
  • Auth: none declared

Headers

x-api-keystring nullable
authorizationstring nullable
x-bellator-internal-dispatchstring nullable

Request body

Example request

{
  "as_planned": {
    "tasks": [
      {
        "duration_days": 10,
        "id": "T1",
        "name": "Design Phase",
        "percent_complete": 0,
        "planned_finish": "2026-01-15",
        "planned_start": "2026-01-01",
        "predecessors": [],
        "resource": "Team A"
      }
    ]
  },
  "as_built": {
    "tasks": [
      {
        "duration_days": 10,
        "id": "T1",
        "name": "Design Phase",
        "percent_complete": 0,
        "planned_finish": "2026-01-15",
        "planned_start": "2026-01-01",
        "predecessors": [],
        "resource": "Team A"
      }
    ]
  }
}

Response

Successful Response

job_idstring required

Unique job identifier

status'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' required

Status of an async job.

Job lifecycle:

  1. QUEUED - Job submitted to queue, waiting for worker
  2. PROCESSING - Worker picked up job and is executing
  3. COMPLETED - Job finished successfully
  4. FAILED - Job encountered an error
  5. CANCELLED - Job was cancelled by user before completion
estimated_completion_secondsinteger required

Estimated time until completion

status_urlstring required

URL to poll job status

created_atstring date-time

Job creation timestamp

Example response

{
  "created_at": "2025-01-08T12:00:00Z",
  "estimated_completion_seconds": 15,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "status_url": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.