get_activity_log

Read the activity log for a given subject. Returns chronological entries with causer, event, and scrubbed properties.

Purpose

Read the activity log for a given subject (e.g. a project or project-user). Returns reverse-chronological entries with causer, event, and properties. Keys matching token | secret | password | api_key | api_secret are stripped before the response returns.

Pass a short morph alias as subject_type — project, project-subscription, project-subscription-plan, project-user, project-resource, etc. The subject_id is the row UUID.

Required ability

activity:read

Input schema

{
  "type": "object",
  "required": ["subject_type", "subject_id"],
  "properties": {
    "subject_type": {
      "type": "string",
      "description": "Morph alias of the model the activity is attached to (e.g. `project`, `project-subscription`, `project-user`)."
    },
    "subject_id": {
      "type": "string",
      "description": "UUID of the subject row."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Maximum entries to return (1..200, default 50)."
    }
  }
}

Output shape

{
  "data": [
    {
      "id": "act_01HX...",
      "log_name": "default",
      "description": "Plan 'Premium Monthly' was updated.",
      "event": "updated",
      "subject_type": "project-subscription-plan",
      "subject_id": "pln_01HX...",
      "causer_type": "user",
      "causer_id": "usr_01HX...",
      "properties": {
        "changes": {
          "price": { "from": "25.00", "to": "29.00" }
        }
      },
      "actor_kind": "human",
      "created_at": "2026-05-18T10:05:00Z"
    }
  ],
  "meta": {
    "subject_type": "project-subscription-plan",
    "subject_id": "pln_01HX...",
    "total": 12,
    "limit": 50
  }
}

Example prompts

"What recent changes happened to plan pln_01HX...?"

"Show me the last 20 actions taken against subscriber usr_01HX...."

Failure modes

TOKEN_MISSING_ABILITY — token lacks activity:read.