Skip to content
POST/api/v1/resources/allocate

Allocate Resources (Placeholder)

Resource allocation optimization - not yet implemented

Request example

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

Request fields from OpenAPI contract

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

FieldTypeRequiredDescription
tasksarray<unknown>RequiredNo description in OpenAPI contract.
tasks[].idstringRequiredUnique task identifier
tasks[].duration_daysnumberOptionalTask duration in days
tasks[].predecessorsarray<string | object | unknown>OptionalList of predecessor task IDs or dependency links. Supports: 'T1', 'T1FS+5 d', 'T2SS-2 d', or DependencyLink objects
tasks[].namestring | nullOptionalTask name
tasks[].resourcestring | nullOptionalResource assigned to task
tasks[].resourcesarray<string>OptionalList of resources assigned (for multi-resource tasks)
tasks[].percent_completenumberOptionalPercent complete (0-100)
tasks[].physical_percent_completenumber | nullOptionalPhysical percent complete (0-100). Manual EVM entry by scheduler (MSP PhysicalPercentComplete). Authoritative for BCWP calculations. Captured separately from percent_complete on MSP imports.
tasks[].planned_startstring | nullOptionalPlanned start date (ISO 8601)
tasks[].planned_finishstring | nullOptionalPlanned finish date (ISO 8601)
tasks[].actual_startstring | nullOptionalActual start date (ISO 8601)
tasks[].actual_finishstring | nullOptionalActual finish date (ISO 8601)
tasks[].baseline_startstring | nullOptionalBaseline start date (ISO 8601)
tasks[].baseline_finishstring | nullOptionalBaseline finish date (ISO 8601)
tasks[].constraint_typestring | nullOptionalConstraint type: ASAP, ALAP, SNET, SNLT, FNET, FNLT, MSO, MFO
tasks[].constraint_datestring | nullOptionalConstraint date if applicable (ISO 8601)
tasks[].task_typestring | nullOptionalTask type classification. Valid values: task (default), milestone, loe, summary, schedule_margin, planning_package, slpp, schedule_visibility. Drives DCMA check exclusions per PAM 200.1 § 3.2.
tasks[].wbs_codestring | nullOptionalWBS code (e.g., '1.2.3')
tasks[].organization_codestring | nullOptionalOrg/dept identifier for anomaly categorization (Progress Audit)
tasks[].custom_field_mapobject | nullOptionalAll WBS/OBS-pattern custom fields discovered in this MS Project file, keyed by alias (e.g., 'CWBS', 'OBS'). Null for XER imports or when no matching aliases exist.
tasks[].forecast_startstring | nullOptionalCurrent forecast start date (ISO 8601)
tasks[].forecast_finishstring | nullOptionalCurrent forecast finish date (ISO 8601)
tasks[].total_float_daysnumber | nullOptionalPre-computed total float in days. Auto-computed by CPM if absent.
tasks[].baseline_duration_daysnumber | nullOptionalBaseline duration in days. Auto-computed from baseline dates if absent.
tasks[].delay_categorystring | nullOptionalDelay attribution category. Valid values: owner, contractor, design, procurement, weather, force_majeure.
tasks[].earned_valuenumber | nullOptionalEarned Value (BCWP) in cost units. Requires options.include_ev_validation.
tasks[].budgeted_costnumber | nullOptionalBudgeted Cost of Work Scheduled (BCWS) in cost units.
tasks[].approval_requiredboolean | nullOptionalWhether this task requires explicit approval before it can start.
tasks[].approval_statusstring | nullOptionalApproval workflow state. Valid values: not_required, pending, approved, rejected.
resourcesarray<string>OptionalAvailable resources

Response example

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

Response fields from OpenAPI contract

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

FieldTypeRequiredDescription
allocationobjectOptionalResource allocation results
messagestringOptionalNo description in OpenAPI contract.

Schema

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

Authentication

  • x-api-key header

Reference details

Operation ID
allocate_resources_api_v1_resources_allocate_post
Section
Resource Management
Tags
Resource Management

Was this page helpful?

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

Topic: Allocate Resources (Placeholder) · Page: /docs/api-reference/allocate_resources_api_v1_resources_allocate_post

TermsPrivacyContact

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