Get Model Activity

Page Outline

• Path Parameters
• Query Parameters
• Behavior
• Response

---

Returns a chronological log of lifecycle events for a specific model, including training runs, configuration changes, status transitions, and collaborator actions.

Base Path: /api/v1/models

Method: GET

Path: /{model_id}/activity

Auth: Requires a valid Bearer token (Authorization: Bearer <JWT>)

Path Parameters

Parameter	Type	Description
model_id	string	Unique identifier of the model

Query Parameters

Parameter	Type	Default	Description
limit	integer	50	Maximum number of activity entries to return (max: 200)
offset	integer	0	Offset for pagination
event_type	string	—	Filter by event type (e.g., model.updated, model.training_started)
from	string (ISO 8601)	—	Start of the time range filter
to	string (ISO 8601)	—	End of the time range filter

Behavior

• Events are returned in reverse-chronological order (newest first).
• Only events for models within the caller's organization are accessible.
• Event types include: model.created, model.updated, model.archived, model.unarchived, model.duplicated, model.deleted, model.training_started, model.training_completed, model.training_failed, model.version_promoted, model.dataset_linked, model.dataset_unlinked, model.collaborator_added, model.collaborator_removed.
• Returns HTTP 404 if the model is not found.

Response

Returns a paginated list of ActivityEvent objects.

{
  "total": 42,
  "limit": 50,
  "offset": 0,
  "events": [
    {
      "id": "evt-001",
      "event_type": "model.training_completed",
      "model_id": "mdl-7f3a19bc",
      "actor": {
        "user_id": "user-001",
        "email": "alice@example.com"
      },
      "metadata": {
        "version": 3,
        "duration_seconds": 312
      },
      "timestamp": "2026-03-13T14:22:10Z"
    }
  ]
}