Sign in
People

Update member

Partially updates a member. Only provided fields will be updated. Supports both API key authentication (X-API-Key header) and session authentication (Bearer token or cookies).

patch/v1/people/{id}

Path parameters

idstring required
Example:mem_abc123def456

Member ID

Request body

userIdstring

User ID to associate with this member

rolestring

Role for the member (built-in role name or custom role ID)

department'none' | 'admin' | 'gov' | 'hr' | 'it' | 'itsm' | 'qms'

Member department

isActiveboolean

Whether to deactivate this member (soft delete)

fleetDmLabelIdnumber

FleetDM label ID for member devices

jobTitlestring

Job title for the member

namestring

Name of the associated user

emailstring

Email of the associated user

createdAtstring

Member join date (createdAt override)

Example request

{
  "userId": "usr_abc123def456",
  "role": "admin",
  "department": "it",
  "fleetDmLabelId": 123,
  "jobTitle": "Software Engineer",
  "name": "John Doe",
  "email": "john@example.com",
  "createdAt": "2024-01-15T00:00:00.000Z"
}

Response

Member updated successfully

idstring required

Member ID

organizationIdstring required

Organization ID this member belongs to

userIdstring required

User ID associated with member

rolestring required

Member role

createdAtstring date-time required

When the member was created

department'none' | 'admin' | 'gov' | 'hr' | 'it' | 'itsm' | 'qms' required

Member department

jobTitleobject nullable required

Job title for the member

isActiveboolean required

Whether member is active

deactivatedboolean required

Whether member is deactivated

fleetDmLabelIdobject nullable required

FleetDM label ID for member devices

Example response

{
  "id": "mem_abc123def456",
  "organizationId": "org_abc123def456",
  "userId": "usr_abc123def456",
  "role": "admin",
  "createdAt": "2024-01-01T00:00:00Z",
  "department": "it",
  "isActive": true,
  "user": {
    "id": "usr_abc123def456",
    "name": "John Doe",
    "email": "john.doe@company.com",
    "emailVerified": true,
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-15T00:00:00Z"
  }
}

Changes