POST/api/v1/resources/allocate

Allocate Resources (Placeholder)

Resource allocation optimization - not yet implemented

Request example

json

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

Request fields from OpenAPI contract

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

Field	Type	Required	Description
tasks	array<unknown>	Required	No description in OpenAPI contract.
tasks[].id	string	Required	Unique task identifier
tasks[].duration_days	number	Optional	Task duration in days
tasks[].predecessors	array<string \| unknown>	Optional	List of predecessor task IDs or dependency links. Supports: 'T1', 'T1FS+5 d', 'T2SS-2 d', or DependencyLink objects
tasks[].name	string \| null	Optional	Task name
tasks[].resource	string \| null	Optional	Resource assigned to task
tasks[].resources	array<string>	Optional	List of resources assigned (for multi-resource tasks)
tasks[].percent_complete	number	Optional	Percent complete (0-100)
tasks[].physical_percent_complete	number \| null	Optional	Physical 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_start	string \| null	Optional	Planned start date (ISO 8601)
tasks[].planned_finish	string \| null	Optional	Planned finish date (ISO 8601)
tasks[].actual_start	string \| null	Optional	Actual start date (ISO 8601)
tasks[].actual_finish	string \| null	Optional	Actual finish date (ISO 8601)
tasks[].baseline_start	string \| null	Optional	Baseline start date (ISO 8601)
tasks[].baseline_finish	string \| null	Optional	Baseline finish date (ISO 8601)
tasks[].constraint_type	string \| null	Optional	Constraint type: ASAP, ALAP, SNET, SNLT, FNET, FNLT, MSO, MFO
tasks[].constraint_date	string \| null	Optional	Constraint date if applicable (ISO 8601)
tasks[].task_type	string \| null	Optional	Task type classification. Valid values: task (default), milestone, loe, summary, schedule_margin, planning_package, slpp, schedule_visibility. Drives which DCMA checks exclude the task.
tasks[].wbs_code	string \| null	Optional	WBS code (e.g., '1.2.3')
tasks[].organization_code	string \| null	Optional	Org/dept identifier for anomaly categorization (Progress Audit)
tasks[].custom_field_map	object \| null	Optional	All 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_start	string \| null	Optional	Current forecast start date (ISO 8601)
tasks[].forecast_finish	string \| null	Optional	Current forecast finish date (ISO 8601)
tasks[].total_float_days	number \| null	Optional	Pre-computed total float in days. Auto-computed by CPM if absent.
tasks[].baseline_duration_days	number \| null	Optional	Baseline duration in days. Auto-computed from baseline dates if absent.
tasks[].delay_category	string \| null	Optional	Delay attribution category. Valid values: owner, contractor, design, procurement, weather, force_majeure.
tasks[].earned_value	number \| null	Optional	Earned Value (BCWP) in cost units. Requires options.include_ev_validation.
tasks[].budgeted_cost	number \| null	Optional	Budgeted Cost of Work Scheduled (BCWS) in cost units.
tasks[].approval_required	boolean \| null	Optional	Whether this task requires explicit approval before it can start.
tasks[].approval_status	string \| null	Optional	Approval workflow state. Valid values: not_required, pending, approved, rejected.
tasks[].duration_distribution_type	string \| integer \| null	Optional	Duration distribution. None, Uniform, Triangular, Normal, Beta, or LogNormal.
tasks[].duration_optimistic	number \| null	Optional	Optimistic duration, as days or a percent of duration_days.
tasks[].duration_most_likely	number \| null	Optional	Most likely duration, as days or a percent of duration_days.
tasks[].duration_pessimistic	number \| null	Optional	Pessimistic duration, as days or a percent of duration_days.
tasks[].duration_confidence_interval	number \| null	Optional	Confidence interval percent, 50 through 100.
tasks[].duration_estimate_unit	string \| null	Optional	duration or percent_of_deterministic.
tasks[].probability_of_existence	number \| null	Optional	Chance the activity occurs, 0 through 100.
tasks[].discrete_risk	string \| null	Optional	Risk id this activity points at.
tasks[].correlation_sources	array<string> \| null	Optional	Named correlation sources, same order as the coefficients.
tasks[].correlation_coefficients	array<number> \| null	Optional	Correlation to each source, percent from -100 through 100.
tasks[].analysis_focal_item	boolean \| null	Optional	Marks a sensitivity target.
tasks[].calendar_id	string \| null	Optional	Calendar whose lost-time model applies.
tasks[].probabilistic_branch	array<object> \| null	Optional	Mutually exclusive successors and their weights.
tasks[].conditional_branch	array<object> \| null	Optional	Successors chosen from the predecessor finish.
resources	array<string>	Optional	Available resources

Response example

json

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

Response fields from OpenAPI contract

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

Field	Type	Required	Description
allocation	object	Optional	Resource allocation results
message	string	Optional	No description in OpenAPI contract.

Schema

json-schema

{
  "$ref": "#/components/schemas/ResourceAllocationResponse"
}

Authentication

API key required

Reference details

Operation ID: allocate_resources
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

Report an issue Suggest improvement

Terms Privacy Contact

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