Update org person

PATCH /orgs/people/{personId}

Path parameters

  • personId string Required

    The organization's person unique document ID, i.e. org.people[].person.

application/json

Body Required

  • permission string

    Determines the person's permissions within the organization. The member and projectManager do not have access to the organization space, they are just employees. A manager has limited access to the organization space, like managing basic organizational settings, invoice information, leave requests, etc. An admin has full control over the organization. The observer can view everything, but not change anything.

    Values are member, projectManager, manager, admin, or observer.

  • startDate string(date-time)

    The start date in ISOString format. See .toISOString().

  • endDate string(date-time)

    The end date in ISOString format. See .toISOString().

  • role string

    Reference to an org role, i.e. org.roles[]._id

  • roleTitle string

    The title of the role. E.g. Director of Sales

  • email string(email)

    The person's email in the organization.

  • departments array[string(ObjectId)]

    Departments this person belongs to. References the organization's departments, i.e. org.departments[]._id.

  • office string(ObjectId)

    The person's office location. References the organization's offices, i.e. org.offices[]._id.

  • canCreateProjects boolean

    If true, this person can create projects for this organization.

    Default value is false.

  • canApproveRoles boolean

    If true, this person can approve project roles.

    Default value is false.

  • canApproveLeaves boolean

    If true, this person can approve leave requests.

    Default value is false.

  • customProperties array[object]

    Display custom properties on the organization's person information page that are not supported by missionX out of the box.

    Hide customProperties attributes Show customProperties attributes object
    • name string

      The custom property name.

    • value

      The custom property value. It can be of any type.

    • canView string

      The minimum role that is allowed to view this property. E.g. If set to manager, both a manager and an admin can view it, but not a member.

      Values are member, projectManager, manager, or admin.

    • description string

      Optional additional information about this property.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • _id string(ObjectId)

      The unique document ID.

    • permission string

      Determines the person's permissions within the organization. The member and projectManager do not have access to the organization space, they are just employees. A manager has limited access to the organization space, like managing basic organizational settings, invoice information, leave requests, etc. An admin has full control over the organization. The observer can view everything, but not change anything.

      Values are member, projectManager, manager, admin, or observer.

    • startDate string(date-time)

      The start date in ISOString format. See .toISOString().

    • endDate string(date-time)

      The end date in ISOString format. See .toISOString().

    • archived boolean

      If true, the person has been removed from the organization.

    • person string

      The person's unique document ID.

    • role string

      Reference to an org role, i.e. org.roles[]._id

    • roleTitle string

      The title of the role. E.g. Director of Sales

    • email string(email)

      The person's email in the organization.

    • departments array[string(ObjectId)]

      Departments this person belongs to. References the organization's departments, i.e. org.departments[]._id.

    • office string(ObjectId)

      The person's office location. References the organization's offices, i.e. org.offices[]._id.

    • invitePendingSince number(integer)

      The timestamp the person was invited to the organization. If this field is defined, it means that the invitation is still pending.

    • canCreateProjects boolean

      If true, this person can create projects for this organization.

      Default value is false.

    • canApproveRoles boolean

      If true, this person can approve project roles.

      Default value is false.

    • canApproveLeaves boolean

      If true, this person can approve leave requests.

      Default value is false.

    • customProperties array[object]

      Display custom properties on the organization's person information page that are not supported by missionX out of the box.

      Hide customProperties attributes Show customProperties attributes object
      • name string

        The custom property name.

      • value

        The custom property value. It can be of any type.

      • canView string

        The minimum role that is allowed to view this property. E.g. If set to manager, both a manager and an admin can view it, but not a member.

        Values are member, projectManager, manager, or admin.

      • description string

        Optional additional information about this property.

  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • message string

      An error message.

    • code string

      An error code to handle specific error responses.

    • data object

      Optionally, additional data to help handle the error.

      Additional properties are allowed.

  • 500 application/json

    Internal Server Error

    Hide response attributes Show response attributes object
    • message string

      An error message.

    • code string

      An error code to handle specific error responses.

    • data object

      Optionally, additional data to help handle the error.

      Additional properties are allowed.

PATCH /orgs/people/{personId}
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"}]}'
Request examples
{
  "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"
    }
  ]
}
Response examples (200)
{
  "_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"
    }
  ]
}
Response examples (400)
{
  "message": "string",
  "code": "string",
  "data": {}
}
Response examples (500)
{
  "message": "string",
  "code": "string",
  "data": {}
}