Skip to content

API reference

Activity

The record of every change, with who made it and through what.

5 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.

List activity#

POST/v1/platform/activity.listRead

Lists Activity entries, newest first: every change made in Bizisy (and, for AI assistants, every preview and failed attempt), with who did it, through what (web or which API key), status (ok, dry_run = preview only, error), a one-line summary and links to what it touched. Owners, admins and HR (in Manage) see the whole organization; everyone else, and every call through the me audience, sees only their own activity. Filter by status, channel (ui, api, mcp, job), action_id, actor_user_id, or subject_id: entries about one record, e.g. a person id from org_people_list (changes to their profile, job, pay, invites and login link). Each entry lists subject_ids (ids only, never names). Page with before = next_before from the previous page; limit defaults to 50 (at most 100).

Who can call it
Manage key any Manage role
Me key anyone
MCP tool
platform_activity_list on My Workplace, HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • status"ok" | "dry_run" | "error"
  • actor_user_idstring
  • action_idstring
  • channel"ui" | "api" | "mcp" | "job"
  • subject_idstring

    A record id (e.g. a person id): only entries about it.

  • beforestring | null

    An entry id: return only entries older than it (next_before of the previous page).

  • limitinteger

    From 1 to 100. Default 50.

Returns

  • entriesobject[]required
    18 fields
    • idstringrequired
    • created_atstringrequired
    • action_idstringrequired
    • action_titlestringrequired
    • kind"read" | "write" | "destructive"required
    • channel"ui" | "api" | "mcp" | "job"required
    • status"ok" | "dry_run" | "error"required
    • dry_runbooleanrequired
    • summarystringrequired
    • actorobject | nullrequired
      7 fields
      • user_idstringrequired
      • person_idstring | nullrequired
      • namestring | nullrequired
      • emailstring | nullrequired
      • credentialobjectrequired
        4 fields
        • kind"session" | "api_key"required
        • idstringrequired
        • namestring | nullrequired
        • appbooleanrequired

          A connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.

      • via_firmstring | null

        Done by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".

      • via_assistantboolean

        A request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".

    • inputobject | nullrequired
    • input_keysstring[] | nullrequired
    • errorobject | nullrequired
      2 fields
      • codestringrequired
      • messagestringrequired
    • linksobject[]required
      2 fields
      • labelstringrequired
      • pathstringrequired
    • subject_idsstring[]required
    • eventsstring[]required
    • has_changesbooleanrequired
    • changes_recordedbooleanrequired
  • next_beforestring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/activity.list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "actor_user_id": "u1",
  "action_id": "org.people.hire",
  "before": "01k0000000000000000000000a"
}'
Response
{
  "data": {
    "entries": [
      {
        "id": "01k0000000000000000000000a",
        "created_at": "2026-10-04T10:00:00.000Z",
        "action_id": "org.people.change_job",
        "action_title": "Change a person's job (effective-dated)",
        "kind": "write",
        "channel": "mcp",
        "status": "dry_run",
        "dry_run": true,
        "summary": "Changed a person's job (from 2026-11-01)",
        "actor": {
          "user_id": "usr1",
          "person_id": "p1",
          "name": "Ana Ferreira",
          "email": "ana@acme.test",
          "credential": {
            "kind": "api_key",
            "id": "k1",
            "name": "Claude",
            "app": false
          }
        },
        "input": {
          "person_id": "p1",
          "title": "Lead"
        },
        "input_keys": null,
        "error": null,
        "links": [
          {
            "label": "Open person",
            "path": "/manage/people/p1"
          }
        ],
        "subject_ids": [
          "p1"
        ],
        "events": [
          "org.person.job_changed.v1"
        ],
        "has_changes": false,
        "changes_recorded": true
      }
    ],
    "next_before": null
  }
}

Get an activity entry#

POST/v1/platform/activity.getRead

Returns one Activity entry by id (the id at the end of a view_url). Owners, admins and HR (in Manage) see the whole organization; everyone else, and every call through the me audience, sees only their own activity. not_found otherwise.

Who can call it
Manage key any Manage role
Me key anyone
MCP tool
platform_activity_get on My Workplace, HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • idstringrequired

Returns

18 fields
  • idstringrequired
  • created_atstringrequired
  • action_idstringrequired
  • action_titlestringrequired
  • kind"read" | "write" | "destructive"required
  • channel"ui" | "api" | "mcp" | "job"required
  • status"ok" | "dry_run" | "error"required
  • dry_runbooleanrequired
  • summarystringrequired
  • actorobject | nullrequired
    7 fields
    • user_idstringrequired
    • person_idstring | nullrequired
    • namestring | nullrequired
    • emailstring | nullrequired
    • credentialobjectrequired
      4 fields
      • kind"session" | "api_key"required
      • idstringrequired
      • namestring | nullrequired
      • appbooleanrequired

        A connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.

    • via_firmstring | null

      Done by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".

    • via_assistantboolean

      A request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".

  • inputobject | nullrequired
  • input_keysstring[] | nullrequired
  • errorobject | nullrequired
    2 fields
    • codestringrequired
    • messagestringrequired
  • linksobject[]required
    2 fields
    • labelstringrequired
    • pathstringrequired
  • subject_idsstring[]required
  • eventsstring[]required
  • has_changesbooleanrequired
  • changes_recordedbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/activity.get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"01k0000000000000000000000a"}'
Response
{
  "data": {
    "id": "01k0000000000000000000000a",
    "created_at": "2026-10-04T10:00:00.000Z",
    "action_id": "org.people.change_job",
    "action_title": "Change a person's job (effective-dated)",
    "kind": "write",
    "channel": "mcp",
    "status": "dry_run",
    "dry_run": true,
    "summary": "Changed a person's job (from 2026-11-01)",
    "actor": {
      "user_id": "usr1",
      "person_id": "p1",
      "name": "Ana Ferreira",
      "email": "ana@acme.test",
      "credential": {
        "kind": "api_key",
        "id": "k1",
        "name": "Claude",
        "app": false
      }
    },
    "input": {
      "person_id": "p1",
      "title": "Lead"
    },
    "input_keys": null,
    "error": null,
    "links": [
      {
        "label": "Open person",
        "path": "/manage/people/p1"
      }
    ],
    "subject_ids": [
      "p1"
    ],
    "events": [
      "org.person.job_changed.v1"
    ],
    "has_changes": false,
    "changes_recorded": true
  }
}

What changed in an activity entry#

POST/v1/platform/activity.changesRead

What one Activity entry changed, record by record: for each record (a profile, a job period, pay, a team, a document…) the fields before and after. You see the values you may see of each person (the same rules as reading them: pay and private details only for the person and for owners, admins and HR in the app; API keys and AI assistants never get other people's private or pay values); other fields are listed as changed with hidden: true. Entries recorded before the change journal have changes_recorded false. Bulk entries (an import) page with after_seq = next_seq. Who may open the entry: as platform_activity_get.

Who can call it
Manage key any Manage role
Me key anyone
Keys and apps
Other people's pay and private values come back hidden (hidden: true, no values).
MCP tool
platform_activity_changes on My Workplace, HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • entry_idstringrequired

    An Activity entry id (platform_activity_list).

  • after_seqinteger

    next_seq of the previous page.

    At least 0.

  • limitinteger

    From 1 to 200. Default 100.

Returns

  • entryobjectrequired
    18 fields
    • idstringrequired
    • created_atstringrequired
    • action_idstringrequired
    • action_titlestringrequired
    • kind"read" | "write" | "destructive"required
    • channel"ui" | "api" | "mcp" | "job"required
    • status"ok" | "dry_run" | "error"required
    • dry_runbooleanrequired
    • summarystringrequired
    • actorobject | nullrequired
      7 fields
      • user_idstringrequired
      • person_idstring | nullrequired
      • namestring | nullrequired
      • emailstring | nullrequired
      • credentialobjectrequired
        4 fields
        • kind"session" | "api_key"required
        • idstringrequired
        • namestring | nullrequired
        • appbooleanrequired

          A connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.

      • via_firmstring | null

        Done by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".

      • via_assistantboolean

        A request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".

    • inputobject | nullrequired
    • input_keysstring[] | nullrequired
    • errorobject | nullrequired
      2 fields
      • codestringrequired
      • messagestringrequired
    • linksobject[]required
      2 fields
      • labelstringrequired
      • pathstringrequired
    • subject_idsstring[]required
    • eventsstring[]required
    • has_changesbooleanrequired
    • changes_recordedbooleanrequired
  • changesobject[]required
    8 fields
    • idstringrequired
    • entry_idstringrequired
    • atstringrequired
    • op"insert" | "update" | "delete"required
    • recordobjectrequired
      4 fields
      • kindstringrequired
      • idstringrequired
      • namestring | nullrequired
      • datestring | nullrequired
    • person_idsstring[]required
    • fieldsobject[]required
      6 fields
      • keystringrequired
      • labelstring | nullrequired
      • tier"public" | "job" | "private" | "pay" | "hr"required
      • beforeobjectrequired
        27 fields (one of several shapes)

        Option 1

        • t"text"required
        • vstringrequired

        Option 2

        • t"number"required
        • vnumberrequired

        Option 3

        • t"bool"required
        • vbooleanrequired

        Option 4

        • t"date"required
        • vstringrequired

        Option 5

        • t"datetime"required
        • vstringrequired

        Option 6

        • t"money"required
        • amountnumberrequired
        • currencystringrequired
        • periodstring | nullrequired

        Option 7

        • t"ref"required
        • kindstring (enum)required

          One of: person, unit, location, title, entity, position, family, level, category, field, document, checklist.

        • idstringrequired
        • namestring | nullrequired

        Option 8

        • t"enum"required
        • setstringrequired
        • vstringrequired

        Option 9

        • t"list"required
        • itemsany[]required

        Option 10

        • t"file"required
        • namestring | nullrequired
        • sizenumber | nullrequired

        Option 11

        • t"secret"required
      • afterobjectrequired
        27 fields (one of several shapes)

        Option 1

        • t"text"required
        • vstringrequired

        Option 2

        • t"number"required
        • vnumberrequired

        Option 3

        • t"bool"required
        • vbooleanrequired

        Option 4

        • t"date"required
        • vstringrequired

        Option 5

        • t"datetime"required
        • vstringrequired

        Option 6

        • t"money"required
        • amountnumberrequired
        • currencystringrequired
        • periodstring | nullrequired

        Option 7

        • t"ref"required
        • kindstring (enum)required

          One of: person, unit, location, title, entity, position, family, level, category, field, document, checklist.

        • idstringrequired
        • namestring | nullrequired

        Option 8

        • t"enum"required
        • setstringrequired
        • vstringrequired

        Option 9

        • t"list"required
        • itemsany[]required

        Option 10

        • t"file"required
        • namestring | nullrequired
        • sizenumber | nullrequired

        Option 11

        • t"secret"required
      • hiddenbooleanrequired
    • truncatedbooleanrequired
  • next_seqinteger | nullrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/activity.changes \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entry_id":"01k0000000000000000000000b","after_seq":99,"limit":200}'
Response
{
  "data": {
    "entry": {
      "id": "01k0000000000000000000000b",
      "created_at": "2026-10-04T10:00:00.000Z",
      "action_id": "org.people.change_job",
      "action_title": "Change a person's job (effective-dated)",
      "kind": "write",
      "channel": "ui",
      "status": "ok",
      "dry_run": false,
      "summary": "Changed a person's job (from 2026-11-01)",
      "actor": {
        "user_id": "usr1",
        "person_id": "p1",
        "name": "Ana Ferreira",
        "email": "ana@acme.test",
        "credential": {
          "kind": "api_key",
          "id": "k1",
          "name": "Claude",
          "app": false
        }
      },
      "input": {
        "person_id": "p1",
        "title": "Lead"
      },
      "input_keys": null,
      "error": null,
      "links": [
        {
          "label": "Open person",
          "path": "/manage/people/p1"
        }
      ],
      "subject_ids": [
        "p1"
      ],
      "events": [
        "org.person.job_changed.v1"
      ],
      "has_changes": true,
      "changes_recorded": true
    },
    "changes": [
      {
        "id": "01k0000000000000000000000c",
        "entry_id": "01k0000000000000000000000b",
        "at": "2026-10-04T10:00:00.000Z",
        "op": "update",
        "record": {
          "kind": "job",
          "id": "j1",
          "name": null,
          "date": "2026-11-01"
        },
        "person_ids": [
          "p1"
        ],
        "truncated": false,
        "fields": [
          {
            "key": "title",
            "label": null,
            "tier": "job",
            "before": {
              "t": "text",
              "v": "Engineer"
            },
            "after": {
              "t": "text",
              "v": "Senior Engineer"
            },
            "hidden": false
          },
          {
            "key": "manager_id",
            "label": null,
            "tier": "job",
            "before": {
              "t": "ref",
              "kind": "person",
              "id": "p2",
              "name": "Rui Costa"
            },
            "after": {
              "t": "ref",
              "kind": "person",
              "id": "p3",
              "name": null
            },
            "hidden": false
          },
          {
            "key": "iban",
            "label": null,
            "tier": "private",
            "before": null,
            "after": null,
            "hidden": true
          }
        ]
      },
      {
        "id": "01k0000000000000000000000d",
        "entry_id": "01k0000000000000000000000b",
        "at": "2026-10-04T10:00:00.000Z",
        "op": "insert",
        "record": {
          "kind": "pay",
          "id": "pay1",
          "name": null,
          "date": "2026-11-01"
        },
        "person_ids": [
          "p1"
        ],
        "truncated": false,
        "fields": [
          {
            "key": "amount",
            "label": null,
            "tier": "pay",
            "before": null,
            "after": {
              "t": "money",
              "amount": 52000,
              "currency": "EUR",
              "period": "year"
            },
            "hidden": false
          },
          {
            "key": "period",
            "label": null,
            "tier": "pay",
            "before": null,
            "after": {
              "t": "enum",
              "set": "pay_period",
              "v": "year"
            },
            "hidden": false
          }
        ]
      }
    ],
    "next_seq": null
  }
}

A person's change history#

POST/v1/platform/activity.about_personRead

The change history of one person (a person id from org_people_list), newest first: every recorded change to their profile, job, pay and other records, with what changed (before and after) and the Activity entry that made it. Values follow the same rules as reading the person (pay and private details only for owners, admins and HR in the app; over an API key or AI assistant those fields show as changed with hidden: true). Owners, admins and HR. Page with before = next_before.

Who can call it
Manage key owner admin hr
Keys and apps
Pay and private values come back hidden (hidden: true, no values).
MCP tool
platform_activity_about_person on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • person_idstringrequired
  • beforestring | null

    next_before of the previous page.

  • limitinteger

    From 1 to 50. Default 20.

Returns

  • itemsobject[]required
    2 fields
    • entryobject | nullrequired
      18 fields
      • idstringrequired
      • created_atstringrequired
      • action_idstringrequired
      • action_titlestringrequired
      • kind"read" | "write" | "destructive"required
      • channel"ui" | "api" | "mcp" | "job"required
      • status"ok" | "dry_run" | "error"required
      • dry_runbooleanrequired
      • summarystringrequired
      • actorobject | nullrequired
        7 fields
        • user_idstringrequired
        • person_idstring | nullrequired
        • namestring | nullrequired
        • emailstring | nullrequired
        • credentialobjectrequired
          4 fields
          • kind"session" | "api_key"required
          • idstringrequired
          • namestring | nullrequired
          • appbooleanrequired

            A connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.

        • via_firmstring | null

          Done by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".

        • via_assistantboolean

          A request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".

      • inputobject | nullrequired
      • input_keysstring[] | nullrequired
      • errorobject | nullrequired
        2 fields
        • codestringrequired
        • messagestringrequired
      • linksobject[]required
        2 fields
        • labelstringrequired
        • pathstringrequired
      • subject_idsstring[]required
      • eventsstring[]required
      • has_changesbooleanrequired
      • changes_recordedbooleanrequired
    • changesobject[]required
      8 fields
      • idstringrequired
      • entry_idstringrequired
      • atstringrequired
      • op"insert" | "update" | "delete"required
      • recordobjectrequired
        4 fields
        • kindstringrequired
        • idstringrequired
        • namestring | nullrequired
        • datestring | nullrequired
      • person_idsstring[]required
      • fieldsobject[]required
        6 fields
        • keystringrequired
        • labelstring | nullrequired
        • tier"public" | "job" | "private" | "pay" | "hr"required
        • beforeobjectrequired
          27 fields (one of several shapes)

          Option 1

          • t"text"required
          • vstringrequired

          Option 2

          • t"number"required
          • vnumberrequired

          Option 3

          • t"bool"required
          • vbooleanrequired

          Option 4

          • t"date"required
          • vstringrequired

          Option 5

          • t"datetime"required
          • vstringrequired

          Option 6

          • t"money"required
          • amountnumberrequired
          • currencystringrequired
          • periodstring | nullrequired

          Option 7

          • t"ref"required
          • kindstring (enum)required

            One of: person, unit, location, title, entity, position, family, level, category, field, document, checklist.

          • idstringrequired
          • namestring | nullrequired

          Option 8

          • t"enum"required
          • setstringrequired
          • vstringrequired

          Option 9

          • t"list"required
          • itemsany[]required

          Option 10

          • t"file"required
          • namestring | nullrequired
          • sizenumber | nullrequired

          Option 11

          • t"secret"required
        • afterobjectrequired
          27 fields (one of several shapes)

          Option 1

          • t"text"required
          • vstringrequired

          Option 2

          • t"number"required
          • vnumberrequired

          Option 3

          • t"bool"required
          • vbooleanrequired

          Option 4

          • t"date"required
          • vstringrequired

          Option 5

          • t"datetime"required
          • vstringrequired

          Option 6

          • t"money"required
          • amountnumberrequired
          • currencystringrequired
          • periodstring | nullrequired

          Option 7

          • t"ref"required
          • kindstring (enum)required

            One of: person, unit, location, title, entity, position, family, level, category, field, document, checklist.

          • idstringrequired
          • namestring | nullrequired

          Option 8

          • t"enum"required
          • setstringrequired
          • vstringrequired

          Option 9

          • t"list"required
          • itemsany[]required

          Option 10

          • t"file"required
          • namestring | nullrequired
          • sizenumber | nullrequired

          Option 11

          • t"secret"required
        • hiddenbooleanrequired
      • truncatedbooleanrequired
  • next_beforestring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/activity.about_person \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person_id":"p1","before":"01k0000000000000000000000c","limit":50}'
Response
{
  "data": {
    "items": [
      {
        "entry": {
          "id": "01k0000000000000000000000b",
          "created_at": "2026-10-04T10:00:00.000Z",
          "action_id": "org.people.change_job",
          "action_title": "Change a person's job (effective-dated)",
          "kind": "write",
          "channel": "ui",
          "status": "ok",
          "dry_run": false,
          "summary": "Changed a person's job (from 2026-11-01)",
          "actor": {
            "user_id": "usr1",
            "person_id": "p1",
            "name": "Ana Ferreira",
            "email": "ana@acme.test",
            "credential": {
              "kind": "api_key",
              "id": "k1",
              "name": "Claude",
              "app": false
            }
          },
          "input": {
            "person_id": "p1",
            "title": "Lead"
          },
          "input_keys": null,
          "error": null,
          "links": [
            {
              "label": "Open person",
              "path": "/manage/people/p1"
            }
          ],
          "subject_ids": [
            "p1"
          ],
          "events": [
            "org.person.job_changed.v1"
          ],
          "has_changes": true,
          "changes_recorded": true
        },
        "changes": [
          {
            "id": "01k0000000000000000000000c",
            "entry_id": "01k0000000000000000000000b",
            "at": "2026-10-04T10:00:00.000Z",
            "op": "update",
            "record": {
              "kind": "job",
              "id": "j1",
              "name": null,
              "date": "2026-11-01"
            },
            "person_ids": [
              "p1"
            ],
            "truncated": false,
            "fields": [
              {
                "key": "title",
                "label": null,
                "tier": "job",
                "before": {
                  "t": "text",
                  "v": "Engineer"
                },
                "after": {
                  "t": "text",
                  "v": "Senior Engineer"
                },
                "hidden": false
              },
              {
                "key": "manager_id",
                "label": null,
                "tier": "job",
                "before": {
                  "t": "ref",
                  "kind": "person",
                  "id": "p2",
                  "name": "Rui Costa"
                },
                "after": {
                  "t": "ref",
                  "kind": "person",
                  "id": "p3",
                  "name": null
                },
                "hidden": false
              },
              {
                "key": "iban",
                "label": null,
                "tier": "private",
                "before": null,
                "after": null,
                "hidden": true
              }
            ]
          },
          {
            "id": "01k0000000000000000000000d",
            "entry_id": "01k0000000000000000000000b",
            "at": "2026-10-04T10:00:00.000Z",
            "op": "insert",
            "record": {
              "kind": "pay",
              "id": "pay1",
              "name": null,
              "date": "2026-11-01"
            },
            "person_ids": [
              "p1"
            ],
            "truncated": false,
            "fields": [
              {
                "key": "amount",
                "label": null,
                "tier": "pay",
                "before": null,
                "after": {
                  "t": "money",
                  "amount": 52000,
                  "currency": "EUR",
                  "period": "year"
                },
                "hidden": false
              },
              {
                "key": "period",
                "label": null,
                "tier": "pay",
                "before": null,
                "after": {
                  "t": "enum",
                  "set": "pay_period",
                  "v": "year"
                },
                "hidden": false
              }
            ]
          }
        ]
      },
      {
        "entry": null,
        "changes": [
          {
            "id": "x2",
            "entry_id": "gone",
            "at": "2026-10-04T10:00:00.000Z",
            "op": "delete",
            "record": {
              "kind": "job",
              "id": "j1",
              "name": null,
              "date": "2026-11-01"
            },
            "person_ids": [
              "p1"
            ],
            "truncated": false,
            "fields": []
          }
        ]
      }
    ],
    "next_before": null
  }
}

My change history#

POST/v1/platform/activity.about_meRead

Changes made to your own records (your profile, job and pay, and your requests about pay levels), newest first: what changed (before and after), when and by whom (you, a colleague, an app or an automatic job). Only what you can see about yourself in Bizisy; records HR keeps to itself are never listed. Page with before = next_before.

Who can call it
Me key anyone
MCP tool
platform_activity_about_me on My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • beforestring | null

    next_before of the previous page.

  • limitinteger

    From 1 to 50. Default 20.

Returns

  • itemsobject[]required
    4 fields
    • entry_idstringrequired
    • atstringrequired
    • byobjectrequired
      3 fields
      • kind"you" | "person" | "app" | "automatic"required
      • namestring | nullrequired
      • person_idstring | nullrequired
    • changesobject[]required
      8 fields
      • idstringrequired
      • entry_idstringrequired
      • atstringrequired
      • op"insert" | "update" | "delete"required
      • recordobjectrequired
        4 fields
        • kindstringrequired
        • idstringrequired
        • namestring | nullrequired
        • datestring | nullrequired
      • person_idsstring[]required
      • fieldsobject[]required
        6 fields
        • keystringrequired
        • labelstring | nullrequired
        • tier"public" | "job" | "private" | "pay" | "hr"required
        • beforeobjectrequired
          27 fields (one of several shapes)

          Option 1

          • t"text"required
          • vstringrequired

          Option 2

          • t"number"required
          • vnumberrequired

          Option 3

          • t"bool"required
          • vbooleanrequired

          Option 4

          • t"date"required
          • vstringrequired

          Option 5

          • t"datetime"required
          • vstringrequired

          Option 6

          • t"money"required
          • amountnumberrequired
          • currencystringrequired
          • periodstring | nullrequired

          Option 7

          • t"ref"required
          • kindstring (enum)required

            One of: person, unit, location, title, entity, position, family, level, category, field, document, checklist.

          • idstringrequired
          • namestring | nullrequired

          Option 8

          • t"enum"required
          • setstringrequired
          • vstringrequired

          Option 9

          • t"list"required
          • itemsany[]required

          Option 10

          • t"file"required
          • namestring | nullrequired
          • sizenumber | nullrequired

          Option 11

          • t"secret"required
        • afterobjectrequired
          27 fields (one of several shapes)

          Option 1

          • t"text"required
          • vstringrequired

          Option 2

          • t"number"required
          • vnumberrequired

          Option 3

          • t"bool"required
          • vbooleanrequired

          Option 4

          • t"date"required
          • vstringrequired

          Option 5

          • t"datetime"required
          • vstringrequired

          Option 6

          • t"money"required
          • amountnumberrequired
          • currencystringrequired
          • periodstring | nullrequired

          Option 7

          • t"ref"required
          • kindstring (enum)required

            One of: person, unit, location, title, entity, position, family, level, category, field, document, checklist.

          • idstringrequired
          • namestring | nullrequired

          Option 8

          • t"enum"required
          • setstringrequired
          • vstringrequired

          Option 9

          • t"list"required
          • itemsany[]required

          Option 10

          • t"file"required
          • namestring | nullrequired
          • sizenumber | nullrequired

          Option 11

          • t"secret"required
        • hiddenbooleanrequired
      • truncatedbooleanrequired
  • next_beforestring | nullrequired
  • linkedbooleanrequired

    False when your login is not linked to a person: there is no history to show.

Errors

validation_failed unauthenticated forbidden not_found rate_limited internal

curl
curl https://api.bizisy.com/v1/platform/activity.about_me \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"before":"01k0000000000000000000000c","limit":20}'
Response
{
  "data": {
    "items": [
      {
        "entry_id": "01k0000000000000000000000b",
        "at": "2026-10-04T10:00:00.000Z",
        "by": {
          "kind": "person",
          "name": "Ana Ferreira",
          "person_id": "p1"
        },
        "changes": [
          {
            "id": "01k0000000000000000000000c",
            "entry_id": "01k0000000000000000000000b",
            "at": "2026-10-04T10:00:00.000Z",
            "op": "update",
            "record": {
              "kind": "job",
              "id": "j1",
              "name": null,
              "date": "2026-11-01"
            },
            "person_ids": [
              "p1"
            ],
            "truncated": false,
            "fields": [
              {
                "key": "title",
                "label": null,
                "tier": "job",
                "before": {
                  "t": "text",
                  "v": "Engineer"
                },
                "after": {
                  "t": "text",
                  "v": "Senior Engineer"
                },
                "hidden": false
              },
              {
                "key": "manager_id",
                "label": null,
                "tier": "job",
                "before": {
                  "t": "ref",
                  "kind": "person",
                  "id": "p2",
                  "name": "Rui Costa"
                },
                "after": {
                  "t": "ref",
                  "kind": "person",
                  "id": "p3",
                  "name": null
                },
                "hidden": false
              },
              {
                "key": "iban",
                "label": null,
                "tier": "private",
                "before": null,
                "after": null,
                "hidden": true
              }
            ]
          }
        ]
      },
      {
        "entry_id": "e2",
        "at": "2026-10-01T09:00:00.000Z",
        "by": {
          "kind": "you",
          "name": null,
          "person_id": null
        },
        "changes": []
      }
    ],
    "next_before": null,
    "linked": true
  }
}

Something missing or wrong on this page? Write to hello@bizisy.com.

Developer docs