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 typedata_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
| Parameter | Type | Kind | Description |
|---|---|---|---|
subject_type | string | filter | The collection of the event's subject (e.g. drafts, agents, or project). |
subject_id | string | filter | The specific record the event happened to. |
kind | string | filter | Machine-readable event kind (e.g. outbox.approve, email_sent). |
severity | string | filter | How loudly the event should render (e.g. info, warning, error). |
run_id | string | filter | The agent_runs row whose run produced the event. |
task_id | string | filter | The task the producing run belonged to. |
q | string | search | Free-text search across title, body. |
sort | string | sort | One of created_at; prefix with - to reverse. |
limit | number | page | Rows to return, 1–100. Defaults to 20. |
cursor | string | page | next_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
| Parameter | Type | Kind | Description |
|---|---|---|---|
id | string | path | The 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.
| Field | Type | Description |
|---|---|---|
object | string | Always timeline-event. |
id | string | Stable object id. Also accepted in place of slug on any path. |
slug | string | URL-safe name, unique within the collection. |
created_at | string | ISO-8601 timestamp of the first write. |
updated_at | string | ISO-8601 timestamp of the most recent write. The cursor sorts on this. |
links | object | Structured references to related records; the one row fans onto each linked timeline. |
run_id | string | The agent_runs row whose run produced the event. |
task_id | string | The task the producing run belonged to. |
source | string | Which pass, hook, or surface wrote the event. |
provider | string | External provider involved, when one was (e.g. resend). |
model | string | Model that produced the event, when one did. |
metrics | object | Numbers the event carries (e.g. counts, costs), keyed by metric name. |
metadata | object | Free-form provenance the producer attached. |
severity | string | How loudly the event should render (e.g. info, warning, error). |
occurred_at | string | When 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.