LL: Lesson Learned
A lesson learned record capturing project experiences, root causes, recommendations, and improvement actions.
Default definition. This article describes the default
LL definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches LL.Entity properties
| Property | Value |
|---|---|
| Entity code | LL |
| Display name | Lesson Learned |
| Plural | Lessons Learned |
| Level | 540 |
Use cases
LL captures organisational learning from project experiences, linked to projects via comboKey SUB|PJ. The lesson_type (Positive/Negative) distinguishes what went well from what went wrong. Categories span the full project lifecycle (Planning, Execution, Risk Management, Stakeholder Engagement, Technical, Procurement, Governance).
Fields
Lesson Overview
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Title |
lesson_type | singleselect | Yes | Lesson Type |
category | singleselect | Yes | Category |
phase | singleselect | Yes | Project Phase |
impact_area | multiselect | Yes | Impact Area |
Root Cause & Actions
| Field | Type | Required | Notes |
|---|---|---|---|
root_cause | text (multi-line) | Root Cause | |
recommendation | text (multi-line) | Recommendation / Preventive Action | |
action_taken | text (multi-line) | Action Taken | |
outcome | text (multi-line) | Outcome / Result |
Description
| Field | Type | Required | Notes |
|---|---|---|---|
description | text (multi-line) | Describe the context, event, and what was learned. |
Ownership & Dates
| Field | Type | Required | Notes |
|---|---|---|---|
owner | reference → user | Owner | |
reviewed_by | reference → user | Reviewed By | |
date_identified | date | Date Identified | |
date_closed | date | Date Closed | |
review_date | date | Review Date |
Documents
| Field | Type | Required | Notes |
|---|---|---|---|
attachments | file |
Relationships
- Related lists:
RISK,ISSUE.
Creating a Lesson Learned via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "LL",
"level": 540,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"lesson_type": "Example",
"category": "Example",
"phase": "Example"
}Listing Lessons Learned records
# All lessons learned in your tenant
GET /v1/entities/LL/SUB