Skip to content
POST/api/v1/analysis/cpm/async

Calculate Critical Path (Async)

Submit CPM calculation as async job (for large schedules >1,000 tasks).

This endpoint queues a CPM calculation job for background processing. Use GET /api/v1/jobs/{job_id} to poll for completion.

Tier Restrictions:

  • Demo/Free: Blocked (use sync endpoint ≤1,000 tasks)
  • Starter+: Allowed

Task Limits:

  • Starter: 2,000 tasks
  • Professional: 5,000 tasks
  • Enterprise: 50,000 tasks
  • Government: 100,000 tasks

Args: request: CPM calculation request api_key: API key for authentication

Returns: Job submission response with job_id and polling_url

Raises: HTTPException 402: Task count exceeds tier limit HTTPException 403: Async not available for tier (demo/free)

Request example

json
json
{
  "tasks": [
    {
      "id": "T1",
      "duration_days": 5
    }
  ]
}

Request fields from OpenAPI contract

Required fields and the optional fields that change this call are listed here. The shared task model stays on the task schema guide.

This table is generated from the endpoint schema in openapi.json.

FieldTypeRequiredDescription
tasksarray<unknown>RequiredList of tasks in the schedule
tasks[].idstringRequiredUnique task identifier
optionsobjectOptionalOptions for CPM calculation.
options.include_network_detailsbooleanOptionalInclude network details (start/finish tasks, relationship types)
options.relationship_typesarray<string> | nullOptionalOptional relationship-type filter for network aggregation and details (FS, SS, FF, SF).

Response example

json
json
{
  "score": 92,
  "grade": "A"
}

Schema

json-schema
{
  "$ref": "#/components/schemas/CPMRequest"
}

Authentication

  • x-api-key header

Reference details

Operation ID
analysis_cpm_async
Section
Analysis
Tags
Analysis
Playground link
/playground?endpoint=%2Fapi%2Fv1%2Fanalysis%2Fcpm%2Fasync&method=post

Was this page helpful?

Your feedback helps us improve docs, reference pages, and Playground flows.

Topic: Calculate Critical Path (Async) · Page: /docs/api-reference/analysis_cpm_async

TermsPrivacyContact

Schedule analysis guidance. Not legal advice. You remain responsible for contract and agency compliance.