Moab logoMoab
Get started
Moab Docs

Timeline Events

The append-only record of what happened to an object.

Base path /api/v1/timeline-events on https://moabcrm.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.

List timeline events

GET /api/v1/timeline-events

curl "https://moabcrm.com/api/v1/timeline-events" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_zest"
Show me the timeline events filtered by subject type
data_query {
  "collection": "timeline_events"
}

Returns a paginated list of timeline-event objects, newest first.

{
  "object": "list",
  "data": [
    {
      "object": "timeline-event",
      "id": "obj_123",
      "subject_type": "subject type",
      "subject_id": "subject_123",
      "kind": "kind",
      "title": "title",
      "body": "body",
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Parameters

ParameterTypeKindDescription
subject_typestringfilterThe collection of the event's subject (e.g. drafts, agents, or project).
subject_idstringfilterThe specific record the event happened to.
kindstringfilterMachine-readable event kind (e.g. outbox.approve, email_sent).
severitystringfilterHow loudly the event should render (e.g. info, warning, error).
run_idstringfilterThe agent_runs row whose run produced the event.
task_idstringfilterThe task the producing run belonged to.
qstringsearchFree-text search across title, body.
sortstringsortOne of created_at; prefix with - to reverse.
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_cursor from the previous page.

Retrieve a timeline-event

GET /api/v1/timeline-events/draft-001

curl "https://moabcrm.com/api/v1/timeline-events/draft-001" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_zest"
Open the timeline-event {id}
data_get {
  "collection": "timeline_events",
  "object_id": "draft-001"
}

Returns the timeline-event object.

{
  "object": "timeline-event",
  "id": "obj_123",
  "subject_type": "subject type",
  "subject_id": "subject_123",
  "kind": "kind",
  "title": "title",
  "body": "body",
  "created_at": "2026-07-25T12:00:00.000Z",
  "updated_at": "2026-07-25T12:00:00.000Z"
}

Parameters

ParameterTypeKindDescription
idstringpathThe timeline-event's id or slug.

What comes back (read-only)

Every timeline-event carries the envelope below. The fields under it are computed or stamped by the platform — they are returned, never sent.

FieldTypeDescription
objectstringAlways timeline-event.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.
linksobjectStructured references to related records; the one row fans onto each linked timeline.
run_idstringThe agent_runs row whose run produced the event.
task_idstringThe task the producing run belonged to.
sourcestringWhich pass, hook, or surface wrote the event.
providerstringExternal provider involved, when one was (e.g. resend).
modelstringModel that produced the event, when one did.
metricsobjectNumbers the event carries (e.g. counts, costs), keyed by metric name.
metadataobjectFree-form provenance the producer attached.
severitystringHow loudly the event should render (e.g. info, warning, error).
occurred_atstringWhen the event happened. Not created_at — that is the object's row clock, which the API envelope carries.

Errors

Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.

On this page

Moab logoMoab

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans