Learnings

Base path /api/v1/learnings on https://trydozer.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 learnings

GET /api/v1/learnings

curl "https://trydozer.com/api/v1/learnings?subject_type=equipment" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_northpit"

Show me the learnings filtered by subject type

data_query {
  "collection": "learnings",
  "where": {
    "subject_type": "equipment"
  }
}

Returns a paginated list of learning objects, newest first.

{
  "object": "list",
  "data": [
    {
      "object": "learning",
      "id": "obj_123",
      "learning": "HT-14 runs hot after 6 hours in the North Pit haul rotation",
      "body": "Coolant temp crossed 95C on three consecutive afternoon shifts; operator confirmed radiator screen dusting.",
      "source": "shift-report",
      "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	Collection of the object this belief is about. Absent means it is about the project as a whole.
`subject_id`	string	filter	Id of the object inside `subject_type` this belief is about.
`source`	string	filter	Where the belief came from — the skill, run or person that recorded it.
`run_id`	string	filter	The run that recorded the belief — the handle to look that run up.
`q`	string	search	Free-text search across `learning`, `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 learning

GET /api/v1/learnings/a60h-12

curl "https://trydozer.com/api/v1/learnings/a60h-12" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_northpit"

Open the learning {id}

data_get {
  "collection": "learnings",
  "object_id": "a60h-12"
}

Returns the learning object.

{
  "object": "learning",
  "id": "obj_123",
  "learning": "HT-14 runs hot after 6 hours in the North Pit haul rotation",
  "body": "Coolant temp crossed 95C on three consecutive afternoon shifts; operator confirmed radiator screen dusting.",
  "source": "shift-report",
  "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 learning's id or slug.

What comes back (read-only)

Every learning 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 `learning`.
`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.
`learning`	string	The belief itself, as a one-line headline.
`body`	string	The evidence behind the belief.
`source`	string	Where the belief came from — the skill, run or person that recorded it.
`subject_type`	string	Collection of the object this belief is about. Absent means it is about the project as a whole.
`subject_id`	string	Id of the object inside `subject_type` this belief is about.
`links`	object	Other objects this belief touches, each `\{collection, id, rel\}`. The learning renders on every linked object's timeline.
`run_id`	string	The run that recorded the belief — the handle to look that run up.
`metadata`	object	Extra provenance the recording tool attached.

Errors

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