Body
Required
-
Determines the person's permissions within the organization. The
member
andprojectManager
do not have access to the organization space, they are just employees. Amanager
has limited access to the organization space, like managing basic organizational settings, invoice information, leave requests, etc. Anadmin
has full control over the organization. Theobserver
can view everything, but not change anything.Values are
member
,projectManager
,manager
,admin
, orobserver
. -
The start date in ISOString format. See .toISOString().
-
The end date in ISOString format. See .toISOString().
-
Reference to an org role, i.e.
org.roles[]._id
-
The title of the role. E.g. Director of Sales
-
The person's email in the organization.
-
Departments this person belongs to. References the organization's departments, i.e.
org.departments[]._id
. -
The person's office location. References the organization's offices, i.e.
org.offices[]._id
. -
If true, this person can create projects for this organization.
Default value is
false
. -
If true, this person can approve project roles.
Default value is
false
. -
If true, this person can approve leave requests.
Default value is
false
. -
Display custom properties on the organization's person information page that are not supported by missionX out of the box.
curl \
--request PATCH 'https://open.api.missionx.ai/v2/orgs/people/{personId}' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"permission":"member","startDate":"2025-05-04T09:42:00Z","endDate":"2025-05-04T09:42:00Z","role":"string","roleTitle":"string","email":"hello@example.com","departments":["string"],"office":"string","canCreateProjects":false,"canApproveRoles":false,"canApproveLeaves":false,"customProperties":[{"name":"string","canView":"member","description":"string"}]}'
{
"permission": "member",
"startDate": "2025-05-04T09:42:00Z",
"endDate": "2025-05-04T09:42:00Z",
"role": "string",
"roleTitle": "string",
"email": "hello@example.com",
"departments": [
"string"
],
"office": "string",
"canCreateProjects": false,
"canApproveRoles": false,
"canApproveLeaves": false,
"customProperties": [
{
"name": "string",
"canView": "member",
"description": "string"
}
]
}
{
"_id": "string",
"permission": "member",
"startDate": "2025-05-04T09:42:00Z",
"endDate": "2025-05-04T09:42:00Z",
"archived": true,
"person": "string",
"role": "string",
"roleTitle": "string",
"email": "hello@example.com",
"departments": [
"string"
],
"office": "string",
"invitePendingSince": 42.0,
"canCreateProjects": false,
"canApproveRoles": false,
"canApproveLeaves": false,
"customProperties": [
{
"name": "string",
"canView": "member",
"description": "string"
}
]
}
{
"message": "string",
"code": "string",
"data": {}
}
{
"message": "string",
"code": "string",
"data": {}
}