List project plan items
Manage a project's plan items, i.e. resource roles, cost or revenue items, milestones and phases.
Query parameters
-
One or more person IDs to filter the results by. This is the
people[].person._id
value. -
One or more department IDs to filter the results by. This is the
org.departments[]._id
value. -
One or more role IDs to filter the results by. This is the
org.roles[]._id
value. -
A start date query to filter the results by. Format is
startDate=<operator> <date>
, e.g.startDate=gt 2025-02-24T00:00:00.000Z
. Acceptable operations arelt
= lower than,lte
= lower than or equal,gt
= greater than,gte
= greater than or equal,eq
= equal. The date is in ISOString. -
An end date query to filter the results by. Format is
endDate=<operator> <date>
, e.g.endDate=lt 2025-02-24T00:00:00.000Z
. Acceptable operations arelt
= lower than,lte
= lower than or equal,gt
= greater than,gte
= greater than or equal,eq
= equal. The date is in ISOString. -
One or more IDs to filter the response by. Compares against the document's
_id
value. -
If true, only archived documents will be returned. Defaults to false. If you need both archived and non-archived, use
withArchived
instead.Values are
false
,true
,0
, or1
. -
If true, both archived and non-archived documents will be returned. Defaults to false.
Values are
false
,true
,0
, or1
. -
A date query to filter the results by the last
updatedAt
value. Format isupdatedAt=<operator> <date>
, e.g.updatedAt=gt 2025-02-24T00:00:00.000Z
. Acceptable operations arelt
= lower than,lte
= lower than or equal,gt
= greater than,gte
= greater than or equal,eq
= equal. The date is in ISOString. -
One or more properties to be included in the response, instead of the full payload. E.g.
select=endDate,projectStatus
. You can also exclude fields by prefixing with a minus sign, e.g.select=-endDate,-projectStatus
, but you cannot mix both. -
Optionally, the field to sort the results by. By default, results are sorted by created date. Only
updatedAt
is supported at this moment (Note:updatedAt
equals tocreatedAt
for documents that have never been updated).Value is
updatedAt
. -
Optionally, the direction to sort the documents by. For ascending (oldest first) use either
1
orasc
. By default sorting is descending (latest first),-1
ordesc
.Values are
1
,asc
,-1
, ordesc
. -
Optionally, change the default document response limit of
40
.Minimum value is
1
, maximum value is100
. Default value is40
. -
Search documents that contain specific words or phrases (keywords). Searches against specific document fields, such as
title
anddescription
. The fields and weight of those fields depend on which collection is being searched. Note: When using search, results are scored based, which means that even non-matching documents can be returned.
curl \
--request GET 'https://open.api.missionx.ai/v2/projects/{projectId}/planItems' \
--header "Authorization: Bearer $ACCESS_TOKEN"
{
"value": [
{
"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": {}
}