API Documentation

API Endpoint

People

People

For more details on how to work with custom fields please refer to Working with custom fields guide.

Supported filter params

  • id

  • email

  • status (1: active, 2: deactivated)

  • person_type (1: user, 2: contact, 3: placeholder)

  • role_id (array)

  • company_id (array)

  • tags

  • query

  • subscribable_type (task, deal, person, company, invoice, page)

  • subscribable_id (array)

  • custom_fields[id] (where id is the identifier of your custom field; for dropdown and multiselect custom fields, use array filter)

  • last_activity_at

  • two_factor_auth

  • team

  • autotracking

  • custom_role_id

  • manager_id

  • project_id

  • timesheet_submission_disabled (boolean)

  • time_tracking_policy_id

  • service_type_id

Supported sort params

  • name

  • email

  • title

  • last_seen_at

  • joined_at

  • role_id

  • autotracking

  • company_name

  • custom_role

  • custom_fields

  • two_factor_auth

  • schedulable

  • manager

Filter operations are supported on this endpoint.

PATCH /api/v2/people/invite
Requestssets user and sends invitationreturns error

PATCH  /api/v2/people/3155/invite

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {},
    "relationships": {
      "company": {
        "data": {
          "type": "companies",
          "id": "2248"
        }
      },
      "subsidiary": {
        "data": {
          "type": "subsidiaries",
          "id": "941"
        }
      },
      "custom_role": {
        "data": {
          "type": "custom_roles",
          "id": "3099"
        }
      }
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3155",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2268@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": 1,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": "2025-11-03T05:06:40.000+01:00",
      "is_user": true,
      "user_id": 3160,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:40.603+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:40.603+01:00",
      "two_factor_auth": false,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 1,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "848"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3159/invite

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "custom_role_id": 0
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "source": {
        "pointer": "data/attributes/company"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not accessible",
      "source": {
        "pointer": "data/attributes/custom_role"
      }
    }
  ]
}

Invite a person
PATCH/api/v2/people/invite

Action used to invite contacts into your Productive organization. By doing so, the contact can accept that invitation and then become a user.

URI Parameters
HideShow
company_id
number (required) Example: 1

company id

custom_role_id
number (required) Example: 1

role id

subsidiary_id
number (optional) Example: 1

subsidiary id

GET /api/v2/people
Requestsreturns people

GET  /api/v2/people

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": [
    {
      "id": "3160",
      "type": "people",
      "attributes": {
        "avatar_url": null,
        "contact": {},
        "deactivated_at": null,
        "email": "user3114@email.com",
        "first_name": "name",
        "last_name": "surname",
        "nickname": null,
        "original_avatar_url": null,
        "role_id": 1,
        "status_emoji": null,
        "status_expires_at": null,
        "status_text": null,
        "time_off_status_sync": true,
        "title": null,
        "archived_at": null,
        "autotracking": false,
        "joined_at": null,
        "last_seen_at": null,
        "invited_at": null,
        "is_user": true,
        "user_id": 3164,
        "tag_list": [],
        "virtual": false,
        "custom_fields": null,
        "created_at": "2025-11-03T05:06:40.828+01:00",
        "placeholder": false,
        "color_id": null,
        "sample_data": false,
        "time_unlocked": false,
        "time_unlocked_on": null,
        "time_unlocked_start_date": null,
        "time_unlocked_end_date": null,
        "time_unlocked_period_id": null,
        "time_unlocked_interval": null,
        "last_activity_at": null,
        "two_factor_auth": false,
        "availabilities": "[]",
        "external_id": null,
        "external_sync": false,
        "hrm_type_id": 1,
        "champion": false,
        "timesheet_submission_disabled": false,
        "offboarding_status": "not_initiated",
        "offboarding_id": null,
        "time_tracking_policy_id": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "851"
          }
        },
        "manager": {
          "meta": {
            "included": false
          }
        },
        "company": {
          "meta": {
            "included": false
          }
        },
        "subsidiary": {
          "meta": {
            "included": false
          }
        },
        "custom_role": {
          "meta": {
            "included": false
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "teams": {
          "meta": {
            "included": false
          }
        },
        "service_types": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "meta": {
            "included": false
          }
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    }
  ],
  "links": {
    "first": "http://api-test.productive.io/api/v2/people?page%5Bnumber%5D=1&page%5Bsize%5D=30",
    "last": "http://api-test.productive.io/api/v2/people?page%5Bnumber%5D=1&page%5Bsize%5D=30"
  },
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "page_size": 30,
    "max_page_size": 200
  }
}

Get people
GET/api/v2/people

GET /api/v2/people/1
Requestsreturns person

GET  /api/v2/people/3163

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3163",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2271@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:40.982+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:40.982+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "853"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Get a person
GET/api/v2/people/{id}

URI Parameters
HideShow
id
number (required) Example: 1

person id

POST /api/v2/people
Requestscreates personcalls schedule_automations with the create triggerreturns error

POST  /api/v2/people

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "first_name": "test name"
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3166",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": null,
      "deactivated_at": null,
      "email": null,
      "first_name": "test name",
      "last_name": null,
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:41.130+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:41.130+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "855"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/people

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "first_name": "test name"
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3168",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": null,
      "deactivated_at": null,
      "email": null,
      "first_name": "test name",
      "last_name": null,
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:41.198+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:41.198+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "856"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/people

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "first_name": ""
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "source": {
        "pointer": "data/attributes/first_name"
      }
    }
  ]
}

Create a person
POST/api/v2/people

URI Parameters
HideShow
first_name: `John` (string, required) - first_name
string (required) 
PATCH /api/v2/people/1
Requestsupdates person and syncs with planhatcalls schedule_automations with the update triggerreturns errorupdates personupdates person

PATCH  /api/v2/people/3172

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "first_name": "new name",
      "tag_list": [
        "junior",
        "remote"
      ]
    },
    "relationships": {
      "subscribers": {
        "data": [
          {
            "type": "people",
            "id": "3173"
          },
          {
            "type": "people",
            "id": "3174"
          }
        ]
      }
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3172",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2272@email.com",
      "first_name": "new name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [
        "junior",
        "remote"
      ],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:41.380+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:41.380+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "859"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3176

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "first_name": "new name",
      "tag_list": [
        "junior",
        "remote"
      ]
    },
    "relationships": {
      "subscribers": {
        "data": [
          {
            "type": "people",
            "id": "3177"
          },
          {
            "type": "people",
            "id": "3178"
          }
        ]
      }
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3176",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2275@email.com",
      "first_name": "new name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [
        "junior",
        "remote"
      ],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:41.509+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:41.509+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "860"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3180

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "first_name": ""
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "source": {
        "pointer": "data/attributes/first_name"
      }
    }
  ]
}

PATCH  /api/v2/people/3184

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "first_name": "new name"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3184",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2280@email.com",
      "first_name": "new name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:41.757+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:41.757+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": "123",
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "863"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3186

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "tag_list": [
        "junior",
        "remote"
      ]
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3186",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2281@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [
        "junior",
        "remote"
      ],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:41.836+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:41.836+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": "123",
      "external_sync": true,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "864"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Update a person
PATCH/api/v2/people/{id}

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/1/resend
Requestsresend invitation mail

PATCH  /api/v2/people/3296/resend

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3296",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "user3238@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": 3,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": "2025-11-03T05:06:47.000+01:00",
      "is_user": true,
      "user_id": 3288,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:47.358+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:47.358+01:00",
      "two_factor_auth": false,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 1,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "916"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Resend email to a person
PATCH/api/v2/people/{id}/resend

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/1/deactivate
Requestsdeactivates personcalls schedule_automations with the deactivate trigger

PATCH  /api/v2/people/3300/deactivate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3300",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": "2025-11-03T05:06:47.000+01:00",
      "email": "user3242@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": 3,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": "2025-11-03T05:06:00.000+01:00",
      "is_user": true,
      "user_id": 3292,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:47.512+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:47.512+01:00",
      "two_factor_auth": false,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 1,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "918"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3302/deactivate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3302",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": "2025-11-03T05:06:47.000+01:00",
      "email": "user3244@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": 3,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": "2025-11-03T05:06:00.000+01:00",
      "is_user": true,
      "user_id": 3294,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:47.607+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:47.607+01:00",
      "two_factor_auth": false,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 1,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "919"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Deactivate a person
PATCH/api/v2/people/{id}/deactivate

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/1/activate
Requestsactivates useractivates user

PATCH  /api/v2/people/3310/activate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3310",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "user3251@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": 3,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": "2025-11-03T05:06:00.000+01:00",
      "is_user": true,
      "user_id": 3301,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:47.902+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:47.902+01:00",
      "two_factor_auth": false,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 1,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "923"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3314/activate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3314",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "user3254@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": 3,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": "2025-11-03T05:06:00.000+01:00",
      "is_user": true,
      "user_id": 3304,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:48.052+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:48.052+01:00",
      "two_factor_auth": false,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 1,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "925"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Activate a person
PATCH/api/v2/people/{id}/activate

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/1/archive
Requestsarchives personcalls schedule_automations with the archive triggerarchives persondeletes bookings and engagements

PATCH  /api/v2/people/3335/archive

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3335",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2362@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": "2025-11-03T05:06:48.000+01:00",
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:48.962+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:48.962+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "934"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3337/archive

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3337",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2363@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": "2025-11-03T05:06:49.000+01:00",
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:49.035+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:49.035+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "935"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3339/archive

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3339",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2364@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": "2025-11-03T05:06:49.000+01:00",
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:49.098+01:00",
      "placeholder": true,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:49.098+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": null,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "936"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3341/archive

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3341",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2365@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": "2025-11-03T05:06:49.000+01:00",
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:49.171+01:00",
      "placeholder": true,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:49.171+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": null,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "937"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Archive a person
PATCH/api/v2/people/{id}/archive

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/1/restore
Requestsrestores personreturns errorrestores personrestores person

PATCH  /api/v2/people/3348/restore

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3348",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2369@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:49.520+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:49.520+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "940"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3350/restore

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses409
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "409",
      "code": "not_archived",
      "title": "Conflict error",
      "source": {}
    }
  ]
}

PATCH  /api/v2/people/3354/restore

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3354",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2372@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:49.727+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:49.728+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "943"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/people/3357/restore

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses403
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "403",
      "code": "email_duplicate",
      "title": "Access Denied",
      "detail": "Email has already been taken",
      "source": {}
    }
  ]
}

Restore a person
PATCH/api/v2/people/{id}/restore

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/merge
Requestsmerges person

PATCH  /api/v2/people/merge

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "winner_id": 3359,
  "loser_id": 3360
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3359",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "person2373@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": null,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": false,
      "user_id": null,
      "tag_list": [],
      "virtual": false,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:49.862+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:49.862+01:00",
      "two_factor_auth": null,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 2,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "945"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Merge a person
PATCH/api/v2/people/merge

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/1/virtualize
Requestsvirtualizes person

PATCH  /api/v2/people/3372/virtualize

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "3372",
    "type": "people",
    "attributes": {
      "avatar_url": null,
      "contact": {},
      "deactivated_at": null,
      "email": "user3295@email.com",
      "first_name": "name",
      "last_name": "surname",
      "nickname": null,
      "original_avatar_url": null,
      "role_id": 3,
      "status_emoji": null,
      "status_expires_at": null,
      "status_text": null,
      "time_off_status_sync": true,
      "title": null,
      "archived_at": null,
      "autotracking": false,
      "joined_at": null,
      "last_seen_at": null,
      "invited_at": null,
      "is_user": true,
      "user_id": 3345,
      "tag_list": [],
      "virtual": true,
      "custom_fields": null,
      "created_at": "2025-11-03T05:06:50.197+01:00",
      "placeholder": false,
      "color_id": null,
      "sample_data": false,
      "time_unlocked": false,
      "time_unlocked_on": null,
      "time_unlocked_start_date": null,
      "time_unlocked_end_date": null,
      "time_unlocked_period_id": null,
      "time_unlocked_interval": null,
      "last_activity_at": "2025-11-03T05:06:50.197+01:00",
      "two_factor_auth": false,
      "availabilities": "[]",
      "external_id": null,
      "external_sync": false,
      "hrm_type_id": 1,
      "champion": false,
      "timesheet_submission_disabled": false,
      "offboarding_status": "not_initiated",
      "offboarding_id": null,
      "time_tracking_policy_id": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "949"
        }
      },
      "manager": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "custom_role": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "teams": {
        "meta": {
          "included": false
        }
      },
      "service_types": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Virtualize a person
PATCH/api/v2/people/{id}/virtualize

URI Parameters
HideShow
id
number (required) Example: 1

person id

PATCH /api/v2/people/1/regenerate_recovery_codes
Requestsgenerates new 2FA codes

PATCH  /api/v2/people/3378/regenerate_recovery_codes

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "people",
    "attributes": {
      "password": "test_password"
    }
  }
}
Responses204
This response has no content.

Regenerate 2FA recovery codes
PATCH/api/v2/people/{id}/regenerate_recovery_codes

URI Parameters
HideShow
id
number (required) Example: 1

person id

Generated by aglio on 03 Nov 2025