List a person's job changes
Returns the person's job changes, newest first (up to 200): waiting for approval (pending), scheduled for
their date, applied, declined, cancelled, or failed when one couldn't be made on its date (failure
says why).
Scope: hr:read · Plan: Pro and Enterprise in live mode; every plan in test mode.
AuthorizationBearer <token>Send Authorization: Bearer <token> on every request. The token is one of:
| Prefix | What it is | Where it may be used |
|---|---|---|
agoo_sk_live_ | Secret key, live mode | Your servers only |
agoo_sk_test_ | Secret key, test mode | Your servers only |
agoo_pk_live_ | Publishable key, live mode | Browsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people. |
agoo_pk_test_ | Publishable key, test mode | As above, in test mode |
Admins create keys in Console → Developers → API keys and choose each key's scopes. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.
Scope: hr:read
person_id*stringThe person's ID.
^person_[0-7][0-9a-hjkmnp-tv-z]{25}$"person_01kjsesxm0e4zbyvkr7bcfxbfg"The person's job changes.
application/json- response
data*array<>next_cursor*|Pass this as cursor to get the next page. null on the last page.
"b3BhcXVlLWN1cnNvcg"has_more*booleancurl -X GET 'https://api.agoohq.com/v1/people/person_01kjsesxm0e4zbyvkr7bcfxbfg/job-changes'{ "data": [ { "id": "pchg_01m6j4p2r6t0v4x8z2b6d0f4hm", "object": "job_change", "person_id": "person_01kjw4mg80efgb5aqbsqnxhtbh", "status": "scheduled", "source": "api", "effective_on": "2026-11-01", "reason": "Promotion after the 2026 review", "fields": [ { "field": "job_title", "label": "Job title", "from": "Operations officer", "to": "Senior operations officer" }, { "field": "grade", "label": "Grade", "from": "G5", "to": "G6" }, { "field": "position_id", "label": "Position", "from": null, "to": "Senior operations officer" } ], "failure": null, "created_at": "2026-10-19T11:20:00Z", "applied_at": null } ], "next_cursor": null, "has_more": false}List a person's employment history GET
Returns every change to the person's job title, department, position, manager, sites, employment type, contract, contracted hours and grade, and their start and leaving dates, newest first by the day each took effect, a page at a time. Each line says what it was and what it became, in words, with the IDs of a department, position, manager or sites. **Scope:** `hr:read` · **Plan:** Pro and Enterprise in live mode; every plan in test mode.
Change a person's job POST
Changes the person's job from a date: applied at once when `effective_on` is today or earlier (up to 90 days back), otherwise `scheduled` and applied on that day (up to a year ahead). Send at least one field; `null` clears one that's optional. - Each field becomes a line of employment history, dated `effective_on`. - `position_id` puts them in a position nobody holds that isn't frozen or closed (and out of the one they held); `null` takes them out of theirs. Positions are part of Growth, Pro and Enterprise. - `manager_id` must be an active person in your directory, never the person themselves. - Fires `person.job_changed` when it's applied: at once, or on its date. **Scope:** `hr:write` · **Plan:** Pro and Enterprise in live mode; every plan in test mode.