Create project plan item
Manage a project's plan items, i.e. resource roles, cost or revenue items, milestones and phases.
Query parameters
-
If set to
0
orfalse
, then all notifications associated with this operation will be disabled. This includes push notifications, emails and asynchronous UI updates. Useful for bulk operations.
Body
Required
-
Determines how a plan item behaves, being tracked and/or affects budgeting. Once set, it cannot be changed.
Values are
role
,cost
,milestone
, orphase
. -
A custom identifier for internal reference by your system (not used by missionX).
-
The start date in ISOString format. See .toISOString(). If omitted, defaults to the project's start date.
-
The end date in ISOString format. See .toISOString(). If omitted, defaults to the project's end date.
-
If the planItem is of type
role
, this is the reference to the organization's person_id
value. This is theorg.people[].person
value. -
One or more departments this role is associated with. References the organization's departments, i.e.
org.departments[]._id
. -
The total hours required for this role.
-
A role associated with this plan item. References the organization's role, i.e.
org.roles[]._id
. -
The title of the role. E.g. Director of Sales
curl \
--request POST 'https://open.api.missionx.ai/v2/projects/{projectId}/planItems' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"type":"role","customId":"string","startDate":"2025-05-04T09:42:00Z","endDate":"2025-05-04T09:42:00Z","person":"string","departments":["string"],"hoursNeeded":42.0,"role":"string","roleTitle":"string"}'
{
"type": "role",
"customId": "string",
"startDate": "2025-05-04T09:42:00Z",
"endDate": "2025-05-04T09:42:00Z",
"person": "string",
"departments": [
"string"
],
"hoursNeeded": 42.0,
"role": "string",
"roleTitle": "string"
}
{
"archived": true,
"_id": "string",
"createdBy": "string",
"createdAt": "2025-05-04T09:42:00Z",
"updatedAt": "2025-05-04T09:42:00Z",
"type": "role",
"customId": "string",
"startDate": "2025-05-04T09:42:00Z",
"endDate": "2025-05-04T09:42:00Z",
"project": "string",
"person": "string",
"departments": [
"string"
],
"hoursNeeded": 42.0,
"role": "string",
"roleTitle": "string"
}
{
"message": "string",
"code": "string",
"data": {}
}
{
"message": "string",
"code": "string",
"data": {}
}