{"openapi":"3.1.0","info":{"title":"WorkFINITY® Workflow AI API","description":"\n## WorkFINITY® Solution Configuration Management System — Workflow AI API\n\nAn enterprise-grade high-performance REST API for authoring, orchestrating, validating, and managing business workflows, state transitions, performer role assignments, and multi-modal conversational AI agents over BPRM.\n\n---\n\n### 🔑 Authentication & Headers\nMost endpoints in this microservice require internal service authentication.\nClick the green **Authorize 🔓** button in Swagger UI and provide your credentials:\n- **`APIKeyHeader (X-Internal-Auth)`**: Your internal service secret `<INTERNAL_SERVICE_SECRET>` (e.g., `wf_internal_...`)\n- **`AppId (X-App-Id)`**: The `Application.Id` GUID context for application-scoped data endpoints\n- **`HTTPBearer (Authorization)`**: Optional .NET-issued Bearer JWT (`Bearer eyJ...`) for user-authenticated sessions\n\nSwagger UI automatically persists your authorization credentials across browser reloads.\n\nPublic diagnostic endpoints (`/health`) do not require authentication.\n\n---\n\n### 🧱 Hierarchy & Database Tables Schema\n- **`dbo.ChecklistDefinition`**: Core workflow entity containing workflow metadata, application scope (`ApplicationId`), checklist type (`Process` / `SubProcess` / `Template`), category/subcategory/entity references in `dbo.CodeManager`, and active status flag (`IsActive`).\n- **`dbo.ChecklistDefinitionVersion`**: Immutable, snapshot-based versioning supporting draft check-out/check-in concurrency guards (`CheckedOutByUserId`, `CheckedInAtUtc`), publication timestamp, and the React Flow canvas snapshot (`DefinitionSnapshotJson`).\n- **`dbo.ItemDefinition`**: Designer nodes of each version capturing execution semantics (`NodeType` Start/End/Gateway/Task, `SplitMode`, `JoinMode`, `ExecutionMode`), position coordinates, and custom configuration.\n- **`dbo.ChecklistItemRoute`**: Directed transitions connecting nodes with evaluation priority, default branch flags (`IsDefault`), and condition rule linkages (`ConditionRuleDefinitionId`).\n- **Typed Task Configurations**:\n  - `dbo.ItemRoleDefinition`: Assigned performer roles and team performers for task nodes (`RoleType='Assignee'`).\n  - `dbo.ItemFormDefinition`: Pinned published form definitions and validation rules for nodes.\n  - `dbo.ItemRuleDefinition`: Pinned business rule evaluations.\n  - `dbo.ItemChecklistDefinition`: Subprocess workflow references (`ProcessMode` Sync/Async).\n  - `dbo.ItemTimerDefinition`: Timer, schedule, escalation, and delay configurations.\n- **`dbo.Role`**: Performer roles and teams (`RoleType='Team'`) providing role-based assignment and participant resolution.\n- **`dbo.CodeManager`**: Hierarchical category, subcategory, entity, role type (`ROLE`), and workflow phase (`WF_PHASE`) reference lookups.\n\n---\n\n### 🤖 Multi-Modal AI & Conversational Agents\n- **AI Workflow Builder**: Generate end-to-end multi-phase workflow graphs and step sequences from natural language descriptions (`/api/ai/workflow-message`).\n- **Interactive Designer Assistant**: Conversational assistant that suggests nodes, modifies steps, connects edges, and validates graph consistency in real time (`/api/ai/designer-assistant`).\n- **Contextual AI Research Agent**: Autonomous agent that researches industry regulations, compliance guidelines, and standard operating procedures to enrich workflow structures.\n- **Smart Notification AI**: AI-crafted notifications, escalation alerts, and multi-channel message routing logic.\n\n---\n\n### 📚 Workflow Library & Catalog\n- **Seed Templates**: Pre-packaged, production-tested industry workflows stored in `dbo.ChecklistDefinition` (`ChecklistType = 'Template'`).\n- **Reusable Blueprints**: Import, instantiate, and customize template workflows into any target application context.\n","termsOfService":"https://workfinity.net/terms","contact":{"name":"WorkFINITY Support","url":"https://workfinity.net/","email":"support@workfinity.net"},"license":{"name":"Proprietary","url":"https://workfinity.net/"},"version":"1.0.0"},"servers":[{"url":"/","description":"Current Server (Auto-detected)"},{"url":"http://localhost:8000","description":"Local Development (Port 8000)"},{"url":"http://localhost:5000","description":"Local Development (Port 5000)"},{"url":"http://localhost:5002","description":"Local Development (Port 5002)"},{"url":"https://workflow-ai-portal.workfinity.com","description":"Production Portal"}],"paths":{"/api/phases":{"get":{"tags":["Workflows"],"summary":"List workflow phases","operationId":"list_phases_root_api_phases_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows":{"get":{"tags":["Workflows"],"summary":"List workflow definitions with filters and pagination","description":"Queries workflow definitions scoped to the application with pagination, search, and status filters.","operationId":"list_workflows_api_workflows_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number","default":1,"title":"Page"},"description":"1-based page number"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Page size limit","default":20,"title":"Pagesize"},"description":"Page size limit"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query across workflow name, workflowKey, or description","title":"Q"},"description":"Full-text search query across workflow name, workflowKey, or description"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by substring in workflow name","title":"Name"},"description":"Filter by substring in workflow name"},{"name":"checklistType","in":"query","required":false,"schema":{"anyOf":[{"enum":["Process","SubProcess"],"type":"string"},{"type":"null"}],"description":"Filter by checklist type","title":"Checklisttype"},"description":"Filter by checklist type"},{"name":"isActive","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by active status","title":"Isactive"},"description":"Filter by active status"},{"name":"lifecycleStatus","in":"query","required":false,"schema":{"anyOf":[{"enum":["Draft","Published","Retired"],"type":"string"},{"type":"null"}],"description":"Filter by latest version's lifecycle status","title":"Lifecyclestatus"},"description":"Filter by latest version's lifecycle status"},{"name":"isCheckedOut","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by checkout lock state of the latest version","title":"Ischeckedout"},"description":"Filter by checkout lock state of the latest version"},{"name":"includeDeleted","in":"query","required":false,"schema":{"type":"boolean","description":"Include soft-deleted workflows","default":false,"title":"Includedeleted"},"description":"Include soft-deleted workflows"},{"name":"sortBy","in":"query","required":false,"schema":{"enum":["name","workflowKey","checklistType","createdAtUtc","updatedAtUtc"],"type":"string","description":"Sort column","default":"createdAtUtc","title":"Sortby"},"description":"Sort column"},{"name":"sortDir","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Sort order","default":"desc","title":"Sortdir"},"description":"Sort order"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ChecklistDefinitionOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Workflows"],"summary":"Create new workflow definition","description":"Creates a new workflow definition with an initial Draft version 1.","operationId":"create_workflow_api_workflows_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}":{"get":{"tags":["Workflows"],"summary":"Get workflow definition by ID","description":"Retrieves a single workflow definition by workflow ID.","operationId":"get_workflow_api_workflows__id__get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id (or one of its version ids)","title":"Id"},"description":"ChecklistDefinition.Id (or one of its version ids)"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Workflows"],"summary":"Update workflow definition metadata","description":"Updates workflow fields with optimistic concurrency check. Returns 409 Conflict if rowVersion does not match current state.","operationId":"update_workflow_api_workflows__id__put","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Workflows"],"summary":"Soft-delete workflow definition","description":"Soft-deletes a draft workflow definition. Requires checkout held by caller.","operationId":"delete_workflow_api_workflows__id__delete","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/checkout":{"post":{"tags":["Workflows"],"summary":"Check out workflow to create an editable draft version","description":"Locks the workflow for editing. If the latest version is Published, creates the next Draft version and copies all items, routes, and task configurations. Sets checkout lock for caller. 409 Conflict if held by someone else.","operationId":"check_out_workflow_api_workflows__id__checkout_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CheckStatusRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionVersionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/checkin":{"post":{"tags":["Workflows"],"summary":"Check in and publish the current draft version","description":"Validates the draft React Flow graph against structural rules and publishes it. Sets LifecycleStatus='Published', records publication timestamp, releases checkout lock, and updates the current published version. 409 Conflict if held by someone else.","operationId":"check_in_workflow_api_workflows__id__checkin_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CheckStatusRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionVersionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/draft":{"delete":{"tags":["Workflows"],"summary":"Discard draft version and revert to latest published version","description":"Deletes the uncommitted draft version along with its nodes and transitions, reverting to the preceding published version. 400 for first version; 409 if checkout lock is held by another user.","operationId":"discard_draft_api_workflows__id__draft_delete","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionVersionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/activate":{"post":{"tags":["Workflows"],"summary":"Activate workflow definition","description":"Activates the workflow definition to enable execution.","operationId":"activate_workflow_api_workflows__id__activate_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/deactivate":{"post":{"tags":["Workflows"],"summary":"Deactivate workflow definition","description":"Deactivates the workflow definition to disable execution.","operationId":"deactivate_workflow_api_workflows__id__deactivate_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistDefinitionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/graph":{"put":{"tags":["Workflows"],"summary":"Save workflow designer graph to draft version","description":"Saves the React Flow designer graph ({nodes: [...], edges: [...]}) to the draft version, synchronizing visual nodes, transitions, and typed task configurations. Accepts either {nodes, edges} directly or {\"definitionSnapshotJson\": graph, \"rowVersion\": \"...\"}. 409 Conflict if draft changed since read or if held by another user.","operationId":"set_workflow_graph_api_workflows__id__graph_put","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"description":"Designer graph object {nodes, edges} or wrapper with definitionSnapshotJson and rowVersion.","title":"Payload"},"examples":{"wrapped_graph":{"summary":"Graph with rowVersion token (Recommended)","value":{"definitionSnapshotJson":{"nodes":[{"id":"start-1","type":"start","position":{"x":100,"y":200},"data":{"label":"Start Application","meta":{"name":"Start Application","phase":"Origination"}}},{"id":"task-1","type":"personTask","position":{"x":350,"y":200},"data":{"label":"Verify Applicant Data","meta":{"name":"Verify Applicant Data","phase":"Underwriting"},"config":{"workflowPerformerRoleId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","selectedForms":[{"formId":"d3b07384-d113-463e-ac39-f47b2c659695"}]}}},{"id":"end-1","type":"end","position":{"x":600,"y":200},"data":{"label":"Approval Decision Complete","meta":{"name":"Approval Decision Complete","phase":"Closure"}}}],"edges":[{"id":"e1","source":"start-1","target":"task-1"},{"id":"e2","source":"task-1","target":"end-1"}]},"rowVersion":"AAAAAAAAB9Q="}},"direct_graph":{"summary":"Direct React Flow graph ({nodes, edges})","value":{"nodes":[{"id":"start-1","type":"start","position":{"x":100,"y":200},"data":{"label":"Start","meta":{"name":"Start","phase":"Origination"}}},{"id":"end-1","type":"end","position":{"x":400,"y":200},"data":{"label":"End","meta":{"name":"End","phase":"Closure"}}}],"edges":[{"id":"e1","source":"start-1","target":"end-1"}]}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionSnapshotOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Workflows"],"summary":"Get latest workflow designer graph snapshot","description":"Returns the visual React Flow designer graph snapshot of the latest version.","operationId":"get_workflow_graph_api_workflows__id__graph_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionSnapshotOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/versions":{"get":{"tags":["Workflows"],"summary":"List version history of a workflow","description":"Queries all versions of the workflow ordered by version descending.","operationId":"list_versions_api_workflows__id__versions_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"sortBy","in":"query","required":false,"schema":{"enum":["version","createdAtUtc","checkedOutAtUtc","checkedInAtUtc","publishedAtUtc"],"type":"string","description":"Sort column","default":"version","title":"Sortby"},"description":"Sort column"},{"name":"sortDir","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Sort direction","default":"desc","title":"Sortdir"},"description":"Sort direction"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ChecklistDefinitionVersionOut"},"title":"Response List Versions Api Workflows  Id  Versions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/{id}/nodes":{"get":{"tags":["Workflows"],"summary":"Get current workflow nodes and typed task configuration","description":"Retrieves all designer graph nodes, transitions, and pinned task configurations (roles, forms, rules, subprocesses, and timers) for the latest active version of the workflow, without requiring a version ID.","operationId":"get_workflow_nodes_api_workflows__id__nodes_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id","title":"Id"},"description":"ChecklistDefinition.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionItemsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/roles":{"get":{"tags":["Roles"],"summary":"List roles","description":"Queries performer roles scoped to the application with pagination and filtering.","operationId":"list_performer_roles_api_roles_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number","default":1,"title":"Page"},"description":"1-based page number"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Page size limit","default":10,"title":"Pagesize"},"description":"Page size limit"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query across role name, roleKey, or description","title":"Q"},"description":"Full-text search query across role name, roleKey, or description"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by role name substring","title":"Name"},"description":"Filter by role name substring"},{"name":"roleType","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by CodeManager ROLE code","title":"Roletype"},"description":"Filter by CodeManager ROLE code"},{"name":"isActive","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by active status","title":"Isactive"},"description":"Filter by active status"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_RoleOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Roles"],"summary":"Create role","description":"Creates a new performer role record.","operationId":"create_performer_role_api_roles_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/roles/{id}":{"get":{"tags":["Roles"],"summary":"Get role by ID","description":"Retrieves a single performer role by ID.","operationId":"get_performer_role_api_roles__id__get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Role.Id","title":"Id"},"description":"Role.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Roles"],"summary":"Update role","description":"Updates an existing performer role with optimistic concurrency check.","operationId":"update_performer_role_api_roles__id__put","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Role.Id","title":"Id"},"description":"Role.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Roles"],"summary":"Delete role","description":"Deletes a performer role by ID.","operationId":"delete_performer_role_api_roles__id__delete","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Role.Id","title":"Id"},"description":"Role.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/roles/import":{"post":{"tags":["Roles"],"summary":"Import roles from a file","description":"Creates performer roles and teams from a CSV or JSON file. Columns: Name (required), RoleKey, RoleType (a ROLE code, or Team), MaxMemberCount, Description, IsActive. Existing keys are skipped; each failed row is reported with its row number. Use dryRun=true to validate only.","operationId":"import_performer_roles_api_roles_import_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"boolean","description":"Validate and report without saving","default":false,"title":"Dryrun"},"description":"Validate and report without saving"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_import_performer_roles_api_roles_import_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/teams":{"get":{"tags":["Teams"],"summary":"List team roles","description":"Queries teams scoped to the application with pagination and filtering.","operationId":"list_teams_api_api_teams_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number","default":1,"title":"Page"},"description":"1-based page number"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Page size limit","default":10,"title":"Pagesize"},"description":"Page size limit"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query across team name, roleKey, or description","title":"Q"},"description":"Full-text search query across team name, roleKey, or description"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by team name substring","title":"Name"},"description":"Filter by team name substring"},{"name":"isActive","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by active status","title":"Isactive"},"description":"Filter by active status"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_RoleOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Teams"],"summary":"Create team","description":"Creates a new operational team record.","operationId":"create_team_api_api_teams_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/teams/{id}":{"get":{"tags":["Teams"],"summary":"Get team by ID","description":"Retrieves a single team record by ID.","operationId":"get_team_api_api_teams__id__get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Team ID (Role.Id)","title":"Id"},"description":"Team ID (Role.Id)"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Teams"],"summary":"Update team","description":"Updates an existing team with optimistic concurrency check.","operationId":"update_team_api_api_teams__id__put","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Team ID (Role.Id)","title":"Id"},"description":"Team ID (Role.Id)"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Teams"],"summary":"Delete team","description":"Deletes a team record by ID.","operationId":"delete_team_api_api_teams__id__delete","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Team ID (Role.Id)","title":"Id"},"description":"Team ID (Role.Id)"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/teams/{team_id}/members":{"get":{"tags":["Teams"],"summary":"List Team Members","operationId":"list_team_members_api_teams__team_id__members_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"isActive","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RoleMemberOut"},"title":"Response List Team Members Api Teams  Team Id  Members Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Teams"],"summary":"Add Team Member","operationId":"add_team_member_api_teams__team_id__members_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleMemberCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleMemberOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/teams/{team_id}/members/{member_id}":{"put":{"tags":["Teams"],"summary":"Update Team Member","operationId":"update_team_member_api_teams__team_id__members__member_id__put","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"member_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"RoleMember.Id","title":"Member Id"},"description":"RoleMember.Id"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleMemberUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleMemberOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Teams"],"summary":"Remove Team Member","operationId":"remove_team_member_api_teams__team_id__members__member_id__delete","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"member_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Member Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai/workflows":{"post":{"tags":["AI Workflows"],"summary":"Generate AI workflow from prompt","description":"Generates an end-to-end multi-phase workflow graph with tasks, roles, rules, and forms from a prompt.","operationId":"create_ai_workflow_from_prompt_api_ai_workflows_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowAIGenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai/notifications":{"post":{"tags":["AI Notifications"],"summary":"Generate notification draft","description":"Generates an intelligent context-aware notification draft and alert content using AI.","operationId":"generate_notification_draft_api_ai_notifications_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationGenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai/research":{"post":{"tags":["AI Research Agent"],"summary":"Run research agent","description":"Search the web for current public information, industry compliance, and benchmarks.","operationId":"run_research_agent_api_ai_research_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_run_research_agent_api_ai_research_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchAgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/templates":{"get":{"tags":["Workflow Library"],"summary":"List workflow templates","description":"Queries reusable workflow blueprint templates, optionally filtered by phase query parameter.","operationId":"list_workflow_library_api_workflows_templates_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional phase filter, e.g. 'Origination'","title":"Phase"},"description":"Optional phase filter, e.g. 'Origination'"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateListOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Workflow Library"],"summary":"Create workflow template","description":"Creates a new reusable workflow blueprint template.","operationId":"create_workflow_library_api_workflows_templates_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/templates/{id}":{"get":{"tags":["Workflow Library"],"summary":"Get workflow template by ID","description":"Retrieves a single workflow blueprint template by ID.","operationId":"get_workflow_library_by_id_api_workflows_templates__id__get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id of the template","title":"Id"},"description":"ChecklistDefinition.Id of the template"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/templates/{id}/graph":{"get":{"tags":["Workflow Library"],"summary":"Get workflow template graph snapshot","description":"Retrieves the canvas graph snapshot of a workflow blueprint template.","operationId":"get_workflow_library_graph_api_workflows_templates__id__graph_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id of the template","title":"Id"},"description":"ChecklistDefinition.Id of the template"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Workflow Library"],"summary":"Update workflow template graph snapshot","description":"Updates the canvas graph snapshot of a workflow blueprint template.","operationId":"update_workflow_library_graph_api_workflows_templates__id__graph_put","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"ChecklistDefinition.Id of the template","title":"Id"},"description":"ChecklistDefinition.Id of the template"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateSnapshotUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/message":{"post":{"tags":["AI Workflows"],"summary":"Workflow AI conversation message","description":"Processes natural-language prompts to generate or refine workflow structures.","operationId":"workflow_message_api_workflows_message_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WorkflowMessageRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowMessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/designer/message":{"post":{"tags":["Designer Assistant"],"summary":"Chat with the workflow designer copilot","description":"Takes current workflow canvas and user instruction to generate incremental graph modifications.","operationId":"designer_assistant_message_api_workflows_designer_message_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DesignerAssistantRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignerAssistantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/designer/from-diagram":{"post":{"tags":["Designer Assistant"],"summary":"Generate workflow graph from diagram image or document","description":"Recreate a designer canvas workflow from an uploaded diagram image/PDF\n(tool-drawn or handwritten). Returns full React Flow wfJson for the canvas.","operationId":"designer_from_diagram_api_workflows_designer_from_diagram_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_designer_from_diagram_api_workflows_designer_from_diagram_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignerFromDiagramResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflows/designer/suggest-continuation":{"post":{"tags":["Designer Assistant"],"summary":"Suggest next logical steps or continuation nodes","operationId":"designer_suggest_continuation_api_workflows_designer_suggest_continuation_post","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-App-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-App-Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SuggestContinuationRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestContinuationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/stats":{"get":{"tags":["Utilities"],"summary":"Application operational runtime statistics","description":"Returns service name, current version, process uptime in seconds, and health status.","operationId":"api_stats_api_stats_get","security":[{"APIKeyHeader":[]},{"HTTPBearer":[]},{"AppId":[]}],"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Runtime operational metrics","content":{"application/json":{"schema":{}}}},"401":{"description":"Missing or invalid internal authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["Health"],"summary":"Service health and readiness check","description":"Liveness probe. Set checkDb=true to perform a live database connection ping.","operationId":"health_health_get","parameters":[{"name":"checkDb","in":"query","required":false,"schema":{"type":"boolean","description":"Ping database connectivity","default":false,"title":"Checkdb"},"description":"Ping database connectivity"}],"responses":{"200":{"description":"Service is healthy and operational","content":{"application/json":{"schema":{"type":"object","title":"Response Health Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health/ready":{"get":{"tags":["Health"],"summary":"Service readiness check","description":"Readiness probe verifying service initialization and live database connectivity.","operationId":"health_ready_health_ready_get","responses":{"200":{"description":"Service is ready to handle traffic","content":{"application/json":{"schema":{}}}},"503":{"description":"Service dependencies are unavailable"}}}}},"components":{"schemas":{"AssistantQuestion":{"properties":{"id":{"type":"string","title":"Id"},"text":{"type":"string","title":"Text"},"type":{"type":"string","enum":["text","radio","select","performer_cascade","entry_condition_select","subprocess_workflow_select"],"title":"Type"},"options":{"anyOf":[{"items":{"$ref":"#/components/schemas/AssistantQuestionOption"},"type":"array"},{"type":"null"}],"title":"Options"},"required":{"type":"boolean","title":"Required","default":true},"defaultValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Defaultvalue"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hint"}},"type":"object","required":["id","text","type"],"title":"AssistantQuestion"},"AssistantQuestionOption":{"properties":{"label":{"type":"string","title":"Label"},"value":{"type":"string","title":"Value"}},"type":"object","required":["label","value"],"title":"AssistantQuestionOption"},"AttachmentCandidate":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""},"score":{"type":"number","title":"Score","default":0.0},"kind":{"type":"string","enum":["form","rule","interface","automation_tool"],"title":"Kind"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["id","name","kind"],"title":"AttachmentCandidate"},"Body_designer_from_diagram_api_workflows_designer_from_diagram_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Workflow diagram image or PDF"},"message":{"type":"string","title":"Message","default":""},"phaseOptions":{"type":"string","title":"Phaseoptions","default":""},"enrich":{"type":"boolean","title":"Enrich","default":true}},"type":"object","required":["file"],"title":"Body_designer_from_diagram_api_workflows_designer_from_diagram_post"},"Body_import_performer_roles_api_roles_import_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Roles as CSV or JSON (docs/import-templates/06-roles.csv)"}},"type":"object","required":["file"],"title":"Body_import_performer_roles_api_roles_import_post"},"Body_run_research_agent_api_ai_research_post":{"properties":{"prompt":{"type":"string","title":"Prompt"},"context":{"type":"string","title":"Context","default":"{}"},"model":{"type":"string","title":"Model","default":"gpt-4o"},"temperature":{"type":"number","title":"Temperature","default":0.2},"notes":{"type":"string","title":"Notes","default":""},"document_text":{"type":"string","title":"Document Text","default":""},"documents":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Documents","default":[]}},"type":"object","required":["prompt"],"title":"Body_run_research_agent_api_ai_research_post"},"CheckStatusRequest":{"properties":{"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes","description":"Optional notes stored as CheckinNotes on check-in or CheckoutNotes on check-out."}},"type":"object","title":"CheckStatusRequest","example":{"notes":"Verified validation rules and performer assignments for production deployment"}},"ChecklistDefinitionCreate":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","description":"Workflow name (dbo.ChecklistDefinition.Name)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Detailed description of the workflow purpose and business rules (dbo.ChecklistDefinition.Description)."},"checklistType":{"type":"string","enum":["Process","SubProcess"],"title":"Checklisttype","description":"Workflow type: 'Process' for top-level processes or 'SubProcess' for reusable sub-workflows (dbo.ChecklistDefinition.ChecklistType).","default":"Process"},"workflowKey":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Workflowkey","description":"Unique business identifier for the workflow within the application. Derived from Name if omitted (dbo.ChecklistDefinition.WorkflowKey)."},"categoryCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Categorycodeid","description":"Foreign key to category CodeManager entry (dbo.ChecklistDefinition.CategoryCodeId)."},"subCategoryCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Subcategorycodeid","description":"Foreign key to subcategory CodeManager entry (dbo.ChecklistDefinition.SubCategoryCodeId)."},"entityCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Entitycodeid","description":"Foreign key to entity CodeManager entry (dbo.ChecklistDefinition.EntityCodeId)."},"metadataJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadatajson","description":"Arbitrary JSON metadata dictionary for workflow tags, phases, and custom configuration (dbo.ChecklistDefinition.MetadataJson)."},"isActive":{"type":"boolean","title":"Isactive","description":"Active/published status flag. Newly created workflows start inactive until approved (dbo.ChecklistDefinition.IsActive).","default":false},"copyFromChecklistDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Copyfromchecklistdefinitionid","description":"Optional ID of an existing workflow in this application to copy initial designer nodes and edges from."}},"type":"object","required":["name"],"title":"ChecklistDefinitionCreate","example":{"checklistType":"Process","description":"Multi-stage automated loan application review, verification, and decision process.","isActive":false,"metadataJson":{"department":"Lending","phase":"Origination"},"name":"Loan Approval Workflow","workflowKey":"loan-approval-workflow"}},"ChecklistDefinitionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique workflow identifier (dbo.ChecklistDefinition.Id)."},"name":{"type":"string","title":"Name","description":"Workflow name (dbo.ChecklistDefinition.Name)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Workflow description (dbo.ChecklistDefinition.Description)."},"checklistType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checklisttype","description":"Workflow classification: 'Process' or 'SubProcess' (dbo.ChecklistDefinition.ChecklistType)."},"workflowKey":{"type":"string","title":"Workflowkey","description":"Unique workflow key scoped to the application (dbo.ChecklistDefinition.WorkflowKey)."},"applicationId":{"type":"string","format":"uuid","title":"Applicationid","description":"Application context GUID (dbo.ChecklistDefinition.ApplicationId)."},"categoryCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Categorycodeid","description":"Category code identifier in dbo.CodeManager."},"categoryName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Categoryname","description":"Resolved display name of category code."},"subCategoryCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Subcategorycodeid","description":"Subcategory code identifier in dbo.CodeManager."},"subCategoryName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategoryname","description":"Resolved display name of subcategory code."},"entityCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Entitycodeid","description":"Entity code identifier in dbo.CodeManager."},"entityName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entityname","description":"Resolved display name of entity code."},"metadataJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadatajson","description":"Workflow metadata dictionary (dbo.ChecklistDefinition.MetadataJson)."},"isActive":{"type":"boolean","title":"Isactive","description":"Operational status flag (dbo.ChecklistDefinition.IsActive)."},"isDeleted":{"type":"boolean","title":"Isdeleted","description":"Soft deletion flag (dbo.ChecklistDefinition.IsDeleted)."},"currentPublishedVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Currentpublishedversionid","description":"Foreign key to currently published version (dbo.ChecklistDefinition.CurrentPublishedVersionId)."},"createdAtUtc":{"type":"string","format":"date-time","title":"Createdatutc","description":"Creation timestamp in UTC."},"createdByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid","description":"UserAccount ID that created this workflow."},"createdByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdbyusername","description":"Resolved username that created this workflow."},"updatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc","description":"Last update timestamp in UTC."},"updatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid","description":"UserAccount ID that last updated this workflow."},"updatedByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedbyusername","description":"Resolved username that last updated this workflow."},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes","description":"Notes from last update operation."},"deletedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deletedatutc","description":"Deletion timestamp in UTC if soft-deleted."},"deletedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Deletedbyuserid","description":"UserAccount ID that performed deletion."},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion","description":"Base64 optimistic concurrency token (dbo.ChecklistDefinition.RowVersion)."},"versionCount":{"type":"integer","title":"Versioncount","description":"Total count of historical versions for this workflow.","default":0},"latestVersion":{"anyOf":[{"$ref":"#/components/schemas/ChecklistDefinitionVersionOut"},{"type":"null"}],"description":"Latest version snapshot of the workflow."}},"type":"object","required":["id","name","workflowKey","applicationId","isActive","isDeleted","createdAtUtc"],"title":"ChecklistDefinitionOut","example":{"applicationId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","categoryName":"Finance","checklistType":"Process","createdAtUtc":"2026-10-19T09:00:00Z","createdByUserId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","createdByUserName":"admin@workfinity.com","currentPublishedVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","description":"Multi-stage automated loan application review and decision process.","entityName":"Commercial Loan","id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","isActive":true,"isDeleted":false,"latestVersion":{"checklistDefinitionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","createdAtUtc":"2026-10-19T09:00:00Z","description":"Production release","id":"7c9e6679-7425-40de-944b-e07fc1f90ae7","isCheckedOut":false,"isEnabled":true,"lifecycleStatus":"Published","publishedAtUtc":"2026-10-19T09:30:00Z","rowVersion":"AAAAAAAAB9Q=","version":1},"metadataJson":{"phase":"Origination"},"name":"Loan Approval Workflow","rowVersion":"AAAAAAAAB9Q=","subCategoryName":"Lending","updatedAtUtc":"2026-10-19T09:30:00Z","updatedByUserId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","updatedByUserName":"admin@workfinity.com","updatedNotes":"Published initial version","versionCount":1,"workflowKey":"loan-approval-workflow"}},"ChecklistDefinitionUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name","description":"Updated workflow name (dbo.ChecklistDefinition.Name)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Updated description (dbo.ChecklistDefinition.Description)."},"checklistType":{"anyOf":[{"type":"string","enum":["Process","SubProcess"]},{"type":"null"}],"title":"Checklisttype","description":"Updated checklist type ('Process' or 'SubProcess')."},"categoryCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Categorycodeid","description":"Updated category CodeManager ID."},"subCategoryCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Subcategorycodeid","description":"Updated subcategory CodeManager ID."},"entityCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Entitycodeid","description":"Updated entity CodeManager ID."},"metadataJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadatajson","description":"Updated metadata dictionary."},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes","description":"Audit notes explaining the reason for update (dbo.ChecklistDefinition.UpdatedNotes)."},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion","description":"Base64 optimistic concurrency token from last read. Triggers 409 Conflict if modified by another user concurrently (dbo.ChecklistDefinition.RowVersion)."}},"type":"object","title":"ChecklistDefinitionUpdate","example":{"checklistType":"Process","description":"Updated multi-stage loan review workflow.","metadataJson":{"department":"Lending","phase":"Origination"},"name":"Loan Approval Workflow (Updated)","rowVersion":"AAAAAAAAB9Q=","updatedNotes":"Updated approval rules and notification thresholds"}},"ChecklistDefinitionVersionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique version identifier (dbo.ChecklistDefinitionVersion.Id)."},"checklistDefinitionId":{"type":"string","format":"uuid","title":"Checklistdefinitionid","description":"Foreign key to parent workflow (dbo.ChecklistDefinitionVersion.ChecklistDefinitionId)."},"version":{"type":"integer","title":"Version","description":"Sequential version number: 1, 2, 3... (dbo.ChecklistDefinitionVersion.Version)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Version release notes or description (dbo.ChecklistDefinitionVersion.Description)."},"lifecycleStatus":{"type":"string","enum":["Draft","Published","Retired"],"title":"Lifecyclestatus","description":"Lifecycle state: 'Draft', 'Published', or 'Retired' (dbo.ChecklistDefinitionVersion.LifecycleStatus)."},"isEnabled":{"type":"boolean","title":"Isenabled","description":"Whether this version is enabled (dbo.ChecklistDefinitionVersion.IsEnabled)."},"isCheckedOut":{"type":"boolean","title":"Ischeckedout","description":"True when locked for editing by a specific user (dbo.ChecklistDefinitionVersion.IsCheckedOut)."},"checkedOutAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Checkedoutatutc","description":"Timestamp when version was checked out in UTC."},"checkedOutByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Checkedoutbyuserid","description":"UserAccount ID holding the checkout lock."},"checkedOutByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkedoutbyusername","description":"Resolved username holding the checkout lock."},"checkoutNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkoutnotes","description":"Notes entered when checked out."},"checkoutExpiresAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Checkoutexpiresatutc","description":"Expiry timestamp after which checkout lock is released."},"checkedInAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Checkedinatutc","description":"Timestamp when version was checked in/published in UTC."},"checkedInByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Checkedinbyuserid","description":"UserAccount ID that checked in the version."},"checkedInByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkedinbyusername","description":"Resolved username that checked in the version."},"checkinNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkinnotes","description":"Notes entered upon check-in."},"publishedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Publishedatutc","description":"Timestamp when version was published in UTC."},"publishedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Publishedbyuserid","description":"UserAccount ID that published the version."},"publishedByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publishedbyusername","description":"Resolved username that published the version."},"basedOnVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Basedonversionid","description":"Preceding version ID this version was branched from."},"createdAtUtc":{"type":"string","format":"date-time","title":"Createdatutc","description":"Creation timestamp in UTC."},"createdByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid","description":"UserAccount ID that created this version."},"updatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc","description":"Last update timestamp in UTC."},"updatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid","description":"UserAccount ID that last updated this version."},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion","description":"Base64 optimistic concurrency token (dbo.ChecklistDefinitionVersion.RowVersion)."}},"type":"object","required":["id","checklistDefinitionId","version","lifecycleStatus","isEnabled","isCheckedOut","createdAtUtc"],"title":"ChecklistDefinitionVersionOut","example":{"checkedOutAtUtc":"2026-10-19T10:00:00Z","checkedOutByUserId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","checkedOutByUserName":"admin@workfinity.com","checklistDefinitionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","checkoutExpiresAtUtc":"2026-10-20T10:00:00Z","checkoutNotes":"Editing stage 2 transitions","createdAtUtc":"2026-10-19T10:00:00Z","createdByUserId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","description":"Initial draft version","id":"7c9e6679-7425-40de-944b-e07fc1f90ae7","isCheckedOut":true,"isEnabled":true,"lifecycleStatus":"Draft","rowVersion":"AAAAAAAAB9Q=","updatedAtUtc":"2026-10-19T10:05:00Z","updatedByUserId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","version":1}},"ChecklistItemRouteOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique edge route identifier (dbo.ChecklistItemRoute.Id)."},"checklistDefinitionVersionId":{"type":"string","format":"uuid","title":"Checklistdefinitionversionid","description":"Foreign key to workflow version (dbo.ChecklistItemRoute.ChecklistDefinitionVersionId)."},"fromItemDefinitionId":{"type":"string","format":"uuid","title":"Fromitemdefinitionid","description":"Source node ItemDefinition ID (dbo.ChecklistItemRoute.FromItemDefinitionId)."},"toItemDefinitionId":{"type":"string","format":"uuid","title":"Toitemdefinitionid","description":"Target node ItemDefinition ID (dbo.ChecklistItemRoute.ToItemDefinitionId)."},"priority":{"type":"integer","title":"Priority","description":"Evaluation priority order when leaving a decision node: 0, 1, 2... (dbo.ChecklistItemRoute.Priority).","default":0},"isDefault":{"type":"boolean","title":"Isdefault","description":"True if this is the default fallback branch when no condition matches (dbo.ChecklistItemRoute.IsDefault).","default":false},"conditionRuleDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conditionruledefinitionid","description":"Foreign key to condition rule (dbo.RuleDefinition.Id)."},"conditionRuleDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conditionruledefinitionversionid","description":"Foreign key to pinned published condition rule version (dbo.RuleDefinitionVersion.Id)."}},"type":"object","required":["id","checklistDefinitionVersionId","fromItemDefinitionId","toItemDefinitionId"],"title":"ChecklistItemRouteOut","description":"A directed edge transition from dbo.ChecklistItemRoute.","example":{"checklistDefinitionVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","fromItemDefinitionId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","id":"94cd5678-9abc-def0-1234-56789abcdef0","isDefault":true,"priority":0,"toItemDefinitionId":"b18da294-71ef-493b-c45e-99124632a63b"}},"ConfigurationWarningOut":{"properties":{"designerNodeId":{"type":"string","title":"Designernodeid","description":"React Flow node identifier in the designer canvas."},"itemName":{"type":"string","title":"Itemname","description":"Display name of the node item."},"configKey":{"type":"string","title":"Configkey","description":"Configuration property name that generated the notice."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","description":"Value that could not be pinned into a typed database table."},"message":{"type":"string","title":"Message","description":"Detailed explanation of the configuration warning."}},"type":"object","required":["designerNodeId","itemName","configKey","message"],"title":"ConfigurationWarningOut","description":"A node setting that was not written as typed task configuration (it stays in ConfigurationJson).","example":{"configKey":"selectedRuleIds","designerNodeId":"task-node-2","itemName":"Automated Underwriting Check","message":"Rule definition version not yet published; configuration retained in ConfigurationJson only.","value":"d3b07384-d113-463e-ac39-f47b2c659695"}},"CrossPhaseEdge":{"properties":{"source":{"type":"string","title":"Source"},"target":{"type":"string","title":"Target"}},"type":"object","required":["source","target"],"title":"CrossPhaseEdge"},"DefinitionSnapshotOut":{"properties":{"checklistDefinitionId":{"type":"string","format":"uuid","title":"Checklistdefinitionid","description":"Foreign key to workflow (dbo.ChecklistDefinition.Id)."},"checklistDefinitionVersionId":{"type":"string","format":"uuid","title":"Checklistdefinitionversionid","description":"Foreign key to version (dbo.ChecklistDefinitionVersion.Id)."},"version":{"type":"integer","title":"Version","description":"Sequential version number."},"lifecycleStatus":{"type":"string","enum":["Draft","Published","Retired"],"title":"Lifecyclestatus","description":"Version status: 'Draft', 'Published', or 'Retired'."},"definitionSnapshotJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Definitionsnapshotjson","description":"The designer graph snapshot containing {nodes: [...], edges: [...]} (dbo.ChecklistDefinitionVersion.DefinitionSnapshotJson)."},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion","description":"Base64 rowVersion token of the version. Send it back on subsequent saves for concurrency safety."},"configurationWarnings":{"items":{"$ref":"#/components/schemas/ConfigurationWarningOut"},"type":"array","title":"Configurationwarnings","description":"Warnings for node configurations that could not be pinned into typed database tables and remain in ConfigurationJson only."},"wF_json":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wf Json","readOnly":true},"wf_json":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wf Json","readOnly":true}},"type":"object","required":["checklistDefinitionId","checklistDefinitionVersionId","version","lifecycleStatus","wF_json","wf_json"],"title":"DefinitionSnapshotOut","example":{"checklistDefinitionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","checklistDefinitionVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","configurationWarnings":[],"definitionSnapshotJson":{"edges":[{"id":"e1","source":"start-1","target":"task-1"},{"id":"e2","source":"task-1","target":"end-1"}],"nodes":[{"data":{"label":"Start","meta":{"name":"Start","phase":"Origination"}},"id":"start-1","position":{"x":100,"y":200},"type":"start"},{"data":{"config":{"workflowPerformerRoleId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"},"label":"Review Documents","meta":{"name":"Review Documents","phase":"Underwriting"}},"id":"task-1","position":{"x":350,"y":200},"type":"personTask"},{"data":{"label":"End","meta":{"name":"End","phase":"Closure"}},"id":"end-1","position":{"x":600,"y":200},"type":"end"}]},"lifecycleStatus":"Draft","rowVersion":"AAAAAAAAB9Q=","version":1}},"DesignerAssistantAction":{"properties":{"type":{"type":"string","enum":["ask_questions","add_node","update_node","delete_node","link_edge","unlink_edge","clear_entry_condition","clear_attachments","suggest_attachments","suggest_entry_conditions","suggest_automation_tools","clarify"],"title":"Type"},"questions":{"anyOf":[{"items":{"$ref":"#/components/schemas/AssistantQuestion"},"type":"array"},{"type":"null"}],"title":"Questions"},"pendingAction":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Pendingaction"},"nodeType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nodetype"},"afterNodeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Afternodeid"},"afterNodeNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Afternodenumber"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"config":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Config"},"edgeLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edgelabel"},"sourceHandle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourcehandle"},"sourceNodeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourcenodeid"},"sourceNodeNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sourcenodenumber"},"targetNodeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Targetnodeid"},"targetNodeNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Targetnodenumber"},"edgeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edgeid"},"nodeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nodeid"},"nodeNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Nodenumber"},"updates":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Updates"},"targetNodeName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Targetnodename"},"candidates":{"anyOf":[{"items":{"$ref":"#/components/schemas/AttachmentCandidate"},"type":"array"},{"type":"null"}],"title":"Candidates"},"suggestedFormType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggestedformtype"},"defaultSelectedIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Defaultselectedids"},"requiresInterfacePicker":{"type":"boolean","title":"Requiresinterfacepicker","default":false},"requiresFormTypePicker":{"type":"boolean","title":"Requiresformtypepicker","default":false},"suggestedInterfaceCategory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggestedinterfacecategory"},"suggestedInterfaceId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggestedinterfaceid"},"formsOnlyPrompt":{"type":"boolean","title":"Formsonlyprompt","default":false},"attachmentKinds":{"anyOf":[{"items":{"type":"string","enum":["forms","rules","interfaces","automation_tools"]},"type":"array"},{"type":"null"}],"title":"Attachmentkinds"},"entryConditionGroups":{"anyOf":[{"items":{"$ref":"#/components/schemas/EntryConditionSuggestionGroup"},"type":"array"},{"type":"null"}],"title":"Entryconditiongroups"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["type"],"title":"DesignerAssistantAction"},"DesignerAssistantRequest":{"properties":{"message":{"type":"string","title":"Message","default":""},"wfJson":{"anyOf":[{},{"type":"null"}],"title":"Wfjson"},"selectedNodeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selectednodeid"},"workflowId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowid"},"questionAnswers":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Questionanswers"},"pendingAction":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Pendingaction"},"phaseOptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Phaseoptions"}},"type":"object","title":"DesignerAssistantRequest"},"DesignerAssistantResponse":{"properties":{"assistantReply":{"type":"string","title":"Assistantreply","default":""},"actions":{"items":{"$ref":"#/components/schemas/DesignerAssistantAction"},"type":"array","title":"Actions"}},"type":"object","title":"DesignerAssistantResponse"},"DesignerFromDiagramResponse":{"properties":{"assistantReply":{"type":"string","title":"Assistantreply","default":""},"wfJson":{"anyOf":[{},{"type":"null"}],"title":"Wfjson"},"enrichmentNotes":{"items":{"type":"string"},"type":"array","title":"Enrichmentnotes"},"executionTimeSec":{"type":"number","title":"Executiontimesec","default":0}},"type":"object","title":"DesignerFromDiagramResponse"},"EntryConditionSuggestionGroup":{"properties":{"edgeId":{"type":"string","title":"Edgeid"},"pathLabel":{"type":"string","title":"Pathlabel"},"branchLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Branchlabel"},"sourceNodeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourcenodeid"},"sourceNodeNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sourcenodenumber"},"sourceNodeName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourcenodename"},"sourceRuleName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourcerulename"},"candidates":{"items":{"$ref":"#/components/schemas/AttachmentCandidate"},"type":"array","title":"Candidates"}},"type":"object","required":["edgeId","pathLabel"],"title":"EntryConditionSuggestionGroup"},"FinalDiagram":{"properties":{"phases":{"items":{"$ref":"#/components/schemas/FinalDiagramPhase"},"type":"array","title":"Phases"},"crossPhaseEdges":{"items":{"$ref":"#/components/schemas/CrossPhaseEdge"},"type":"array","title":"Crossphaseedges"},"wfJson":{"type":"string","title":"Wfjson"}},"type":"object","required":["phases","crossPhaseEdges","wfJson"],"title":"FinalDiagram"},"FinalDiagramPhase":{"properties":{"id":{"type":"string","title":"Id"},"order":{"type":"integer","title":"Order"},"name":{"type":"string","title":"Name"},"diagramSpec":{"type":"object","title":"Diagramspec"},"wfJson":{"type":"string","title":"Wfjson"}},"type":"object","required":["id","order","name","diagramSpec","wfJson"],"title":"FinalDiagramPhase"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ImportResult":{"properties":{"ok":{"type":"boolean","title":"Ok"},"dryRun":{"type":"boolean","title":"Dryrun"},"entity":{"type":"string","title":"Entity"},"summary":{"$ref":"#/components/schemas/ImportSummary"},"errors":{"items":{"$ref":"#/components/schemas/ImportRowError"},"type":"array","title":"Errors","default":[]}},"type":"object","required":["ok","dryRun","entity","summary"],"title":"ImportResult"},"ImportRowError":{"properties":{"row":{"type":"integer","title":"Row"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["row","reason"],"title":"ImportRowError"},"ImportSummary":{"properties":{"created":{"type":"integer","title":"Created","default":0},"skipped":{"type":"integer","title":"Skipped","default":0},"errors":{"type":"integer","title":"Errors","default":0}},"type":"object","title":"ImportSummary"},"ItemChecklistDefinitionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique record identifier (dbo.ItemChecklistDefinition.Id)."},"childChecklistDefinitionId":{"type":"string","format":"uuid","title":"Childchecklistdefinitionid","description":"Foreign key to invoked child workflow (dbo.ChecklistDefinition.Id)."},"childChecklistName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Childchecklistname","description":"Display name of the child workflow."},"childChecklistDefinitionVersionId":{"type":"string","format":"uuid","title":"Childchecklistdefinitionversionid","description":"Foreign key to pinned published child version (dbo.ChecklistDefinitionVersion.Id)."},"processMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processmode","description":"Execution mode: 'Sync' (blocking) or 'Async' (background) (dbo.ItemChecklistDefinition.ProcessMode)."},"isEnabled":{"type":"boolean","title":"Isenabled","description":"Active flag for subprocess launch (dbo.ItemChecklistDefinition.IsEnabled)."}},"type":"object","required":["id","childChecklistDefinitionId","childChecklistDefinitionVersionId","isEnabled"],"title":"ItemChecklistDefinitionOut","description":"Subprocess workflow invocation from dbo.ItemChecklistDefinition.","example":{"childChecklistDefinitionId":"9e667974-2540-de94-4be0-7fc1f90ae78a","childChecklistDefinitionVersionId":"f90ae78a-3fa8-5f64-5717-4562b3fc2c96","childChecklistName":"Identity & KYC Verification Subprocess","id":"b18da294-71ef-493b-c45e-99124632a63b","isEnabled":true,"processMode":"Sync"}},"ItemDefinitionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique node item identifier (dbo.ItemDefinition.Id)."},"checklistDefinitionId":{"type":"string","format":"uuid","title":"Checklistdefinitionid","description":"Foreign key to workflow (dbo.ChecklistDefinition.Id)."},"checklistDefinitionVersionId":{"type":"string","format":"uuid","title":"Checklistdefinitionversionid","description":"Foreign key to version (dbo.ChecklistDefinitionVersion.Id)."},"nodeId":{"type":"string","format":"uuid","title":"Nodeid","description":"Stable node UUID preserved across version checkouts (dbo.ItemDefinition.NodeId)."},"nodeNumber":{"type":"integer","title":"Nodenumber","description":"Sequential node order number within the version (dbo.ItemDefinition.NodeNumber)."},"name":{"type":"string","title":"Name","description":"Node label or title (dbo.ItemDefinition.Name)."},"itemType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Itemtype","description":"Designer node type: 'start', 'end', 'personTask', 'automatedTask', 'decisionTask', etc. (dbo.ItemDefinition.ItemType)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Node description (dbo.ItemDefinition.Description)."},"workflowPhase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowphase","description":"Phase group name in dbo.CodeManager (dbo.ItemDefinition.WorkflowPhase)."},"nodeType":{"type":"string","title":"Nodetype","description":"Execution node category: 'Start', 'End', 'Gateway', or 'Task' (dbo.ItemDefinition.NodeType)."},"executionMode":{"type":"string","title":"Executionmode","description":"Execution concurrency: 'Sequential' or 'Parallel' (dbo.ItemDefinition.ExecutionMode)."},"splitMode":{"type":"string","title":"Splitmode","description":"Branching mode: 'None', 'Exclusive' (decision), or 'Parallel' (dbo.ItemDefinition.SplitMode)."},"joinMode":{"type":"string","title":"Joinmode","description":"Merging mode: 'None', 'Exclusive', or 'Parallel' (dbo.ItemDefinition.JoinMode)."},"timeoutSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timeoutseconds","description":"Task timeout threshold in seconds (dbo.ItemDefinition.TimeoutSeconds)."},"slaSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Slaseconds","description":"Service level agreement target in seconds (dbo.ItemDefinition.SlaSeconds)."},"isEnabled":{"type":"boolean","title":"Isenabled","description":"Active flag for node execution (dbo.ItemDefinition.IsEnabled)."},"configurationJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Configurationjson","description":"Raw designer node position, canvas coordinates, and raw config dictionary (dbo.ItemDefinition.ConfigurationJson)."},"createdAtUtc":{"type":"string","format":"date-time","title":"Createdatutc","description":"Creation timestamp in UTC."},"updatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc","description":"Last update timestamp in UTC."},"roles":{"items":{"$ref":"#/components/schemas/ItemRoleDefinitionOut"},"type":"array","title":"Roles","description":"Assigned performer roles from dbo.ItemRoleDefinition."},"forms":{"items":{"$ref":"#/components/schemas/ItemFormDefinitionOut"},"type":"array","title":"Forms","description":"Pinned forms from dbo.ItemFormDefinition."},"rules":{"items":{"$ref":"#/components/schemas/ItemRuleDefinitionOut"},"type":"array","title":"Rules","description":"Pinned business rules from dbo.ItemRuleDefinition."},"subprocesses":{"items":{"$ref":"#/components/schemas/ItemChecklistDefinitionOut"},"type":"array","title":"Subprocesses","description":"Invoked subprocesses from dbo.ItemChecklistDefinition."},"timers":{"items":{"$ref":"#/components/schemas/ItemTimerDefinitionOut"},"type":"array","title":"Timers","description":"Configured timers from dbo.ItemTimerDefinition."}},"type":"object","required":["id","checklistDefinitionId","checklistDefinitionVersionId","nodeId","nodeNumber","name","nodeType","executionMode","splitMode","joinMode","isEnabled","createdAtUtc"],"title":"ItemDefinitionOut","description":"A workflow node entity from dbo.ItemDefinition.","example":{"checklistDefinitionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","checklistDefinitionVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","configurationJson":{"config":{"workflowPerformerRoleId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"},"designerNodeId":"task-1","position":{"x":350,"y":200}},"createdAtUtc":"2026-10-19T10:00:00Z","description":"Manual review of borrower documents and income verification","executionMode":"Sequential","forms":[],"id":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","isEnabled":true,"itemType":"personTask","joinMode":"None","name":"Underwriter Review","nodeId":"6f1c7a52-31f4-4a43-9a43-2f1e1c2b7d10","nodeNumber":1,"nodeType":"Task","roles":[{"id":"4da78ef9-8132-4e89-b14a-10f7b587a82b","isEnabled":true,"roleId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","roleName":"Senior Underwriter","roleType":"Assignee"}],"rules":[],"slaSeconds":86400,"splitMode":"None","subprocesses":[],"timeoutSeconds":172800,"timers":[],"updatedAtUtc":"2026-10-19T10:05:00Z","workflowPhase":"Underwriting"}},"ItemFormDefinitionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique record identifier (dbo.ItemFormDefinition.Id)."},"orderNumber":{"type":"integer","title":"Ordernumber","description":"Form presentation sequence number: 1..n (dbo.ItemFormDefinition.OrderNumber)."},"formDefinitionId":{"type":"string","format":"uuid","title":"Formdefinitionid","description":"Foreign key to form entity (dbo.FormDefinition.Id)."},"formName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formname","description":"Display name of the form definition."},"formDefinitionVersionId":{"type":"string","format":"uuid","title":"Formdefinitionversionid","description":"Foreign key to pinned published form version (dbo.FormDefinitionVersion.Id)."},"ruleDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Ruledefinitionid","description":"Foreign key to optional validation rule (dbo.RuleDefinition.Id)."},"ruleName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rulename","description":"Display name of the validation rule."},"ruleDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Ruledefinitionversionid","description":"Foreign key to pinned published rule version (dbo.RuleDefinitionVersion.Id)."}},"type":"object","required":["id","orderNumber","formDefinitionId","formDefinitionVersionId"],"title":"ItemFormDefinitionOut","description":"Pinned form definition from dbo.ItemFormDefinition.","example":{"formDefinitionId":"d3b07384-d113-463e-ac39-f47b2c659695","formDefinitionVersionId":"e1f72a91-4567-48de-89ab-0123456789ab","formName":"Borrower Financial Statement","id":"a93bc45e-9912-4632-a63b-18da294c71ef","orderNumber":1,"ruleDefinitionId":"f2e83b02-5678-49ef-90bc-1234567890cd","ruleDefinitionVersionId":"a3f94c13-6789-40fa-a1cd-2345678901de","ruleName":"Validate Loan Debt Ratio"}},"ItemRoleDefinitionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique record identifier (dbo.ItemRoleDefinition.Id)."},"roleType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roletype","description":"Performer assignment mode: 'Assignee' (dbo.ItemRoleDefinition.RoleType)."},"roleId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Roleid","description":"Foreign key to dbo.Role (performer role or team)."},"roleName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rolename","description":"Display name of the assigned performer role or team."},"isEnabled":{"type":"boolean","title":"Isenabled","description":"Active flag for role assignment (dbo.ItemRoleDefinition.IsEnabled)."}},"type":"object","required":["id","isEnabled"],"title":"ItemRoleDefinitionOut","description":"Assigned performer role row from dbo.ItemRoleDefinition.","example":{"id":"4da78ef9-8132-4e89-b14a-10f7b587a82b","isEnabled":true,"roleId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","roleName":"Senior Underwriter","roleType":"Assignee"}},"ItemRuleDefinitionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique record identifier (dbo.ItemRuleDefinition.Id)."},"orderNumber":{"type":"integer","title":"Ordernumber","description":"Rule evaluation sequence number: 1..n (dbo.ItemRuleDefinition.OrderNumber)."},"ruleDefinitionId":{"type":"string","format":"uuid","title":"Ruledefinitionid","description":"Foreign key to business rule (dbo.RuleDefinition.Id)."},"ruleName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rulename","description":"Display name of the business rule."},"ruleDefinitionVersionId":{"type":"string","format":"uuid","title":"Ruledefinitionversionid","description":"Foreign key to pinned published rule version (dbo.RuleDefinitionVersion.Id)."},"isEnabled":{"type":"boolean","title":"Isenabled","description":"Active flag for rule execution (dbo.ItemRuleDefinition.IsEnabled)."}},"type":"object","required":["id","orderNumber","ruleDefinitionId","ruleDefinitionVersionId","isEnabled"],"title":"ItemRuleDefinitionOut","description":"Pinned business rule definition from dbo.ItemRuleDefinition.","example":{"id":"c71ef24a-1043-481b-94cd-56789abcdef0","isEnabled":true,"orderNumber":1,"ruleDefinitionId":"f2e83b02-5678-49ef-90bc-1234567890cd","ruleDefinitionVersionId":"a3f94c13-6789-40fa-a1cd-2345678901de","ruleName":"Check Credit Score Threshold"}},"ItemTimerDefinitionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique record identifier (dbo.ItemTimerDefinition.Id)."},"initialDelaySeconds":{"type":"integer","title":"Initialdelayseconds","description":"Initial delay in seconds before timer fires (dbo.ItemTimerDefinition.InitialDelaySeconds)."},"repeatEverySeconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Repeateveryseconds","description":"Interval in seconds for recurring timer executions (dbo.ItemTimerDefinition.RepeatEverySeconds)."},"maxOccurrences":{"type":"integer","title":"Maxoccurrences","description":"Maximum times timer fires: 1 for one-shot, >1 for repeat (dbo.ItemTimerDefinition.MaxOccurrences)."},"misfirePolicy":{"type":"string","title":"Misfirepolicy","description":"Action taken if timer execution is delayed or skipped (dbo.ItemTimerDefinition.MisfirePolicy)."},"messageBody":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Messagebody","description":"Alert message or notification body dispatched by timer (dbo.ItemTimerDefinition.MessageBody)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable timer description (dbo.ItemTimerDefinition.Description)."},"startInterfaceDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Startinterfacedefinitionid","description":"Optional start trigger interface ID."},"endInterfaceDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Endinterfacedefinitionid","description":"Optional stop trigger interface ID."},"isEnabled":{"type":"boolean","title":"Isenabled","description":"Active flag for timer execution (dbo.ItemTimerDefinition.IsEnabled)."}},"type":"object","required":["id","initialDelaySeconds","maxOccurrences","misfirePolicy","isEnabled"],"title":"ItemTimerDefinitionOut","description":"Timer/scheduler configuration from dbo.ItemTimerDefinition.","example":{"description":"Send daily reminders up to 3 times before escalation","id":"e7fc1f90-ae78-43fa-85f6-457174562b3f","initialDelaySeconds":86400,"isEnabled":true,"maxOccurrences":3,"messageBody":"Reminder: Underwriting review pending applicant response","misfirePolicy":"FireAndProceed","repeatEverySeconds":3600}},"Message":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"Message"},"NotificationAlertContext":{"properties":{"alert_type":{"type":"string","title":"Alert Type"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"help_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help Text"}},"type":"object","required":["alert_type"],"title":"NotificationAlertContext"},"NotificationGenerateRequest":{"properties":{"context":{"type":"object","title":"Context"},"prompt":{"type":"string","minLength":3,"title":"Prompt"},"model":{"type":"string","title":"Model","default":"gpt-4o"},"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","default":0.5},"alert_type":{"type":"string","title":"Alert Type","default":"email-alert"},"workflow":{"anyOf":[{"$ref":"#/components/schemas/NotificationWorkflowContext"},{"type":"null"}]},"traversal":{"anyOf":[{"$ref":"#/components/schemas/NotificationTraversalContext"},{"type":"null"}]},"alert":{"anyOf":[{"$ref":"#/components/schemas/NotificationAlertContext"},{"type":"null"}]},"form_values":{"additionalProperties":{"type":"object"},"type":"object","title":"Form Values"},"flat_values":{"type":"object","title":"Flat Values"},"rule_outcomes":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Rule Outcomes"},"agent_outputs":{"type":"object","title":"Agent Outputs"}},"type":"object","required":["prompt"],"title":"NotificationGenerateRequest"},"NotificationTraversalContext":{"properties":{"completed_node_ids":{"items":{"type":"string"},"type":"array","title":"Completed Node Ids"},"traversed_edge_ids":{"items":{"type":"string"},"type":"array","title":"Traversed Edge Ids"},"completed_nodes":{"items":{"$ref":"#/components/schemas/NotificationTraversalNode"},"type":"array","title":"Completed Nodes"},"recent_events":{"items":{"$ref":"#/components/schemas/NotificationTraversalEvent"},"type":"array","title":"Recent Events"}},"type":"object","title":"NotificationTraversalContext"},"NotificationTraversalEvent":{"properties":{"type":{"type":"string","title":"Type"},"message":{"type":"string","title":"Message"},"node_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node Id"}},"type":"object","required":["type","message"],"title":"NotificationTraversalEvent"},"NotificationTraversalNode":{"properties":{"node_id":{"type":"string","title":"Node Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase"}},"type":"object","required":["node_id","name","type"],"title":"NotificationTraversalNode"},"NotificationWorkflowContext":{"properties":{"workflow_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Id"},"workflow_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Name"},"current_node_id":{"type":"string","title":"Current Node Id"},"current_task_name":{"type":"string","title":"Current Task Name"},"current_task_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Task Phase"}},"type":"object","required":["current_node_id","current_task_name"],"title":"NotificationWorkflowContext"},"Page_ChecklistDefinitionOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ChecklistDefinitionOut"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"pageSize":{"type":"integer","title":"Pagesize"},"total":{"type":"integer","title":"Total"},"totalPages":{"type":"integer","title":"Totalpages","default":0}},"type":"object","required":["items","page","pageSize","total"],"title":"Page[ChecklistDefinitionOut]"},"Page_RoleOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/RoleOut"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"pageSize":{"type":"integer","title":"Pagesize"},"total":{"type":"integer","title":"Total"},"totalPages":{"type":"integer","title":"Totalpages","default":0}},"type":"object","required":["items","page","pageSize","total"],"title":"Page[RoleOut]"},"Phase":{"properties":{"id":{"type":"string","title":"Id"},"order":{"type":"integer","title":"Order"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"version":{"type":"integer","title":"Version","default":0}},"type":"object","required":["id","order","name","status"],"title":"Phase"},"PhaseOption":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["id","label"],"title":"PhaseOption"},"PhaseUpdate":{"properties":{"phaseId":{"type":"string","title":"Phaseid"},"status":{"type":"string","title":"Status"},"version":{"type":"integer","title":"Version"},"templateOrigin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Templateorigin"},"diagramSpec":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Diagramspec"}},"type":"object","required":["phaseId","status","version"],"title":"PhaseUpdate"},"Question":{"properties":{"id":{"type":"string","title":"Id"},"phaseId":{"type":"string","title":"Phaseid"},"text":{"type":"string","title":"Text"},"type":{"type":"string","title":"Type"},"options":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Options"}},"type":"object","required":["id","phaseId","text","type"],"title":"Question"},"ResearchAgentResponse":{"properties":{"summary":{"type":"string","title":"Summary"},"report_text":{"type":"string","title":"Report Text"},"subjects":{"items":{"$ref":"#/components/schemas/ResearchSubject"},"type":"array","title":"Subjects"},"findings":{"items":{"$ref":"#/components/schemas/ResearchFinding"},"type":"array","title":"Findings"},"sources":{"items":{"$ref":"#/components/schemas/ResearchSource"},"type":"array","title":"Sources"},"decision_support":{"type":"string","title":"Decision Support"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"queries":{"items":{"type":"string"},"type":"array","title":"Queries"},"documents_reviewed":{"items":{"type":"string"},"type":"array","title":"Documents Reviewed"},"model":{"type":"string","title":"Model"},"temperature":{"type":"number","title":"Temperature"},"prompt":{"type":"string","title":"Prompt"}},"type":"object","required":["summary","report_text","decision_support","confidence","model","temperature","prompt"],"title":"ResearchAgentResponse"},"ResearchFinding":{"properties":{"subject":{"type":"string","title":"Subject"},"headline":{"type":"string","title":"Headline"},"detail":{"type":"string","title":"Detail"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"}},"type":"object","required":["subject","headline","detail"],"title":"ResearchFinding"},"ResearchSource":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"}},"type":"object","required":["title","url"],"title":"ResearchSource"},"ResearchSubject":{"properties":{"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind"}},"type":"object","required":["name","kind"],"title":"ResearchSubject"},"RoleCreate":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","description":"Performer role display name (dbo.Role.Name)."},"roleKey":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[-_0-9a-z]+$"},{"type":"null"}],"title":"Rolekey","description":"Unique role key within application (dbo.Role.RoleKey). Derived from Name if omitted."},"roleType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Roletype","description":"Role classification code, matching a CodeManager row of CodeType 'ROLE' (dbo.Role.RoleType)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Detailed description of responsibilities (dbo.Role.Description)."},"maxMemberCount":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Maxmembercount","description":"Maximum active user members permitted for this role. NULL allows unlimited members (dbo.Role.MaxMemberCount)."},"isActive":{"type":"boolean","title":"Isactive","description":"Active status flag (dbo.Role.IsActive).","default":true}},"type":"object","required":["name"],"title":"RoleCreate","example":{"description":"Reviews loan and credit applications for underwriting decisioning","isActive":true,"name":"Underwriter","roleKey":"underwriter","roleType":"MANAGER"}},"RoleMemberCreate":{"properties":{"userAccountId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Useraccountid"},"userName":{"anyOf":[{"type":"string","maxLength":256,"minLength":1},{"type":"null"}],"title":"Username"},"isActive":{"type":"boolean","title":"Isactive","default":true}},"type":"object","title":"RoleMemberCreate"},"RoleMemberOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"roleId":{"type":"string","format":"uuid","title":"Roleid"},"userAccountId":{"type":"string","format":"uuid","title":"Useraccountid"},"userName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname"},"applicationId":{"type":"string","format":"uuid","title":"Applicationid"},"clientId":{"type":"string","format":"uuid","title":"Clientid"},"isActive":{"type":"boolean","title":"Isactive"},"createdAtUtc":{"type":"string","format":"date-time","title":"Createdatutc"},"createdByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"},"createdByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdbyusername"},"updatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc"},"updatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion"}},"type":"object","required":["id","roleId","userAccountId","applicationId","clientId","isActive","createdAtUtc"],"title":"RoleMemberOut"},"RoleMemberUpdate":{"properties":{"isActive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive"},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion"}},"type":"object","title":"RoleMemberUpdate"},"RoleOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique role identifier (dbo.Role.Id)."},"name":{"type":"string","title":"Name","description":"Role display name (dbo.Role.Name)."},"roleKey":{"type":"string","title":"Rolekey","description":"Unique role key (dbo.Role.RoleKey)."},"roleType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roletype","description":"Role type code (dbo.Role.RoleType)."},"roleTypeCodeId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Roletypecodeid","description":"CodeManager row ID matching RoleType."},"roleTypeName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roletypename","description":"Resolved display name from CodeManager."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Role description (dbo.Role.Description)."},"applicationId":{"type":"string","format":"uuid","title":"Applicationid","description":"Application context ID (dbo.Role.ApplicationId)."},"clientId":{"type":"string","format":"uuid","title":"Clientid","description":"Tenant client ID (dbo.Role.ClientId)."},"maxMemberCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Maxmembercount","description":"Active member limit (dbo.Role.MaxMemberCount)."},"isActive":{"type":"boolean","title":"Isactive","description":"Active flag (dbo.Role.IsActive)."},"createdAtUtc":{"type":"string","format":"date-time","title":"Createdatutc","description":"Creation timestamp in UTC."},"createdByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid","description":"Creator user ID."},"createdByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdbyusername","description":"Creator username."},"updatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc","description":"Last update timestamp in UTC."},"updatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid","description":"Updater user ID."},"updatedByUserName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedbyusername","description":"Updater username."},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes","description":"Audit notes."},"workflowAssignment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowassignment","description":"Workflow assignment strategy."},"metadataJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadatajson","description":"Resolved metadata."},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion","description":"Base64 rowVersion token (dbo.Role.RowVersion)."}},"type":"object","required":["id","name","roleKey","applicationId","clientId","isActive","createdAtUtc"],"title":"RoleOut","example":{"applicationId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","clientId":"b2c3d4e5-f6a7-8901-bcde-f12345678901","createdAtUtc":"2026-10-19T09:00:00Z","createdByUserId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","createdByUserName":"admin@workfinity.com","description":"Reviews complex tier-2 and commercial applications","id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","isActive":true,"maxMemberCount":10,"name":"Senior Underwriter","roleKey":"senior-underwriter","roleType":"MANAGER","roleTypeCodeId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","roleTypeName":"Manager Level","rowVersion":"AAAAAAAAB9Q=","updatedAtUtc":"2026-10-19T09:30:00Z","updatedByUserId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","updatedByUserName":"admin@workfinity.com","updatedNotes":"Initial setup"}},"RoleUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name","description":"Updated role name."},"roleType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Roletype","description":"Updated role classification code."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Updated role description."},"maxMemberCount":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Maxmembercount","description":"Updated member quota limit."},"clearMaxMemberCount":{"type":"boolean","title":"Clearmaxmembercount","description":"Set to True to remove the member limit (sets MaxMemberCount = NULL in dbo.Role).","default":false},"isActive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive","description":"Updated active status."},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes","description":"Audit note documenting reasons for update."},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion","description":"Base64 rowVersion concurrency token. 409 Conflict if modified concurrently."}},"type":"object","title":"RoleUpdate","example":{"clearMaxMemberCount":false,"description":"Reviews complex tier-2 and commercial applications","isActive":true,"maxMemberCount":10,"name":"Senior Underwriter","roleType":"MANAGER","rowVersion":"AAAAAAAAB9Q=","updatedNotes":"Expanded responsibilities to tier-2 loans"}},"SuggestContinuationRequest":{"properties":{"wfJson":{"anyOf":[{},{"type":"null"}],"title":"Wfjson"},"selectedNodeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selectednodeid"},"domainHint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domainhint"}},"type":"object","title":"SuggestContinuationRequest"},"SuggestContinuationResponse":{"properties":{"anchorNodeId":{"type":"string","title":"Anchornodeid","default":""},"rationale":{"type":"string","title":"Rationale","default":""},"nodes":{"items":{"$ref":"#/components/schemas/SuggestedNode"},"type":"array","title":"Nodes"},"edges":{"items":{"$ref":"#/components/schemas/SuggestedEdge"},"type":"array","title":"Edges"},"enrichmentNotes":{"items":{"type":"string"},"type":"array","title":"Enrichmentnotes"}},"type":"object","title":"SuggestContinuationResponse"},"SuggestedEdge":{"properties":{"sourceTempId":{"type":"string","title":"Sourcetempid"},"targetTempId":{"type":"string","title":"Targettempid"},"label":{"type":"string","title":"Label","default":""},"sourceHandle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourcehandle"},"targetHandle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Targethandle"}},"type":"object","required":["sourceTempId","targetTempId"],"title":"SuggestedEdge"},"SuggestedNode":{"properties":{"tempId":{"type":"string","title":"Tempid"},"type":{"type":"string","title":"Type"},"name":{"type":"string","title":"Name"},"phase":{"type":"string","title":"Phase","default":"default"},"description":{"type":"string","title":"Description","default":""},"offsetX":{"type":"number","title":"Offsetx","default":0},"offsetY":{"type":"number","title":"Offsety","default":220},"config":{"$ref":"#/components/schemas/SuggestedNodeConfig"},"configHints":{"items":{"type":"string"},"type":"array","title":"Confighints"}},"type":"object","required":["tempId","type","name"],"title":"SuggestedNode"},"SuggestedNodeConfig":{"properties":{"entryConditionRuleId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entryconditionruleid"},"entryConditionHelpText":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entryconditionhelptext"},"performerType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Performertype"},"workflowPerformerRoleId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowperformerroleid"},"workflowPerformerRoleName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowperformerrolename"},"dynamicPerformerId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dynamicperformerid"},"dynamicPerformerName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dynamicperformername"},"formType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formtype"},"selectedForms":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"title":"Selectedforms"},"interfaceCategory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interfacecategory"},"interfaceType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interfacetype"},"interfaceName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interfacename"},"alertType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alerttype"},"expression":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expression"}},"type":"object","title":"SuggestedNodeConfig"},"TeamCreate":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","description":"Team display name (dbo.Role.Name)."},"roleKey":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[-_0-9a-z]+$"},{"type":"null"}],"title":"Rolekey","description":"Unique team identifier key. Derived from Name if omitted."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Team description and mission (dbo.Role.Description)."},"maxMemberCount":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Maxmembercount","description":"Maximum members allowed in this team."},"isActive":{"type":"boolean","title":"Isactive","description":"Active status flag.","default":true},"workflowAssignment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowassignment","description":"Workflow assignment strategy."},"metadataJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadatajson","description":"Arbitrary metadata dictionary."},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes","description":"Audit notes or serialized metadata."}},"type":"object","required":["name"],"title":"TeamCreate","example":{"description":"Primary underwriting review queue for retail loan applications","isActive":true,"maxMemberCount":25,"name":"Underwriting Team Alpha","roleKey":"underwriting-team-alpha"}},"TeamUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name","description":"Updated team name."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Updated team description."},"maxMemberCount":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Maxmembercount","description":"Updated member quota."},"clearMaxMemberCount":{"type":"boolean","title":"Clearmaxmembercount","description":"Set True to remove team size cap.","default":false},"isActive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive","description":"Updated active status."},"workflowAssignment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowassignment","description":"Workflow assignment strategy."},"metadataJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadatajson","description":"Resolved metadata."},"updatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes","description":"Audit notes."},"rowVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rowversion","description":"Base64 rowVersion concurrency token."}},"type":"object","title":"TeamUpdate","example":{"clearMaxMemberCount":false,"description":"Primary tier-1 underwriting review queue","isActive":true,"maxMemberCount":30,"name":"Underwriting Team Alpha (Tier-1)","rowVersion":"AAAAAAAAB9Q=","updatedNotes":"Increased team capacity to 30 members"}},"TemplateCreate":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","description":"Template workflow name."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Detailed explanation of the template blueprint."},"workflowKey":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Workflowkey","description":"Unique key for template. Derived from Name if omitted."},"metadataJson":{"type":"object","title":"Metadatajson","description":"Metadata dictionary; must include 'phase' property."},"definitionSnapshotJson":{"anyOf":[{},{"type":"null"}],"title":"Definitionsnapshotjson","description":"Optional initial React Flow graph with {nodes, edges}."}},"type":"object","required":["name","metadataJson"],"title":"TemplateCreate","example":{"definitionSnapshotJson":{"edges":[{"id":"e1","source":"start","target":"end"}],"nodes":[{"data":{"label":"Start"},"id":"start","position":{"x":100,"y":200},"type":"start"},{"data":{"label":"End"},"id":"end","position":{"x":400,"y":200},"type":"end"}]},"description":"Standard multi-department employee onboarding blueprint","metadataJson":{"industry":"HR","phase":"Origination Phase"},"name":"Employee Onboarding Workflow","workflowKey":"employee-onboarding-workflow"}},"TemplateListOut":{"properties":{"phase":{"type":"string","title":"Phase","description":"Workflow phase name grouping these templates."},"count":{"type":"integer","title":"Count","description":"Total count of templates in this phase."},"items":{"items":{"$ref":"#/components/schemas/TemplateOut"},"type":"array","title":"Items","description":"List of template definitions belonging to this phase."}},"type":"object","required":["phase","count","items"],"title":"TemplateListOut","example":{"count":1,"items":[{"checklistType":"Template","id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","isActive":true,"isDeleted":false,"metadataJson":{"phase":"Application Phase"},"name":"Standard Loan Approval Blueprint"}],"phase":"Application Phase"}},"TemplateOption":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"thumbnailSummary":{"type":"string","title":"Thumbnailsummary","default":""},"diagramSpec":{"type":"object","title":"Diagramspec"},"wfJson":{"type":"string","title":"Wfjson"},"templateOrigin":{"type":"string","title":"Templateorigin","default":"preset"}},"type":"object","required":["id","title","diagramSpec","wfJson"],"title":"TemplateOption"},"TemplateOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique template identifier (dbo.ChecklistDefinition.Id)."},"name":{"type":"string","title":"Name","description":"Template title (dbo.ChecklistDefinition.Name)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Template description (dbo.ChecklistDefinition.Description)."},"checklistType":{"type":"string","title":"Checklisttype","description":"Always 'Template' for workflow library entries.","default":"Template"},"workflowKey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowkey","description":"Unique template identifier key (dbo.ChecklistDefinition.WorkflowKey)."},"applicationId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Applicationid","description":"Optional owning application ID."},"metadataJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadatajson","description":"Dictionary containing the required 'phase' property."},"isActive":{"type":"boolean","title":"Isactive","description":"Active status flag."},"isDeleted":{"type":"boolean","title":"Isdeleted","description":"Soft deletion flag."},"createdAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdatutc","description":"Creation timestamp in UTC."},"checklistDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Checklistdefinitionversionid","description":"Draft version ID holding template graph snapshot."},"definitionSnapshotJson":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Definitionsnapshotjson","description":"The blueprint designer graph with {nodes, edges}."}},"type":"object","required":["id","name","isActive","isDeleted"],"title":"TemplateOut","example":{"applicationId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","checklistDefinitionVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","checklistType":"Template","createdAtUtc":"2026-10-19T09:00:00Z","definitionSnapshotJson":{"edges":[{"id":"e1","source":"s1","target":"t1"},{"id":"e2","source":"t1","target":"e1"}],"nodes":[{"data":{"label":"Start"},"id":"s1","position":{"x":100,"y":200},"type":"start"},{"data":{"label":"Review"},"id":"t1","position":{"x":300,"y":200},"type":"personTask"},{"data":{"label":"End"},"id":"e1","position":{"x":500,"y":200},"type":"end"}]},"description":"Pre-configured template workflow with underwriting, risk check, and decision phases","id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","isActive":true,"isDeleted":false,"metadataJson":{"category":"Banking","phase":"Application Phase"},"name":"Standard Loan Approval Blueprint","workflowKey":"standard-loan-approval-blueprint"}},"TemplateSnapshotUpdate":{"properties":{"checklistDefinitionId":{"type":"string","format":"uuid","title":"Checklistdefinitionid","description":"Foreign key to template workflow (dbo.ChecklistDefinition.Id)."},"definitionSnapshotJson":{"title":"Definitionsnapshotjson","description":"The designer graph object or JSON text to store in the template's draft version."}},"type":"object","required":["checklistDefinitionId","definitionSnapshotJson"],"title":"TemplateSnapshotUpdate","example":{"checklistDefinitionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","definitionSnapshotJson":{"edges":[{"id":"e1","source":"s1","target":"t1"},{"id":"e2","source":"t1","target":"e1"}],"nodes":[{"data":{"label":"Start"},"id":"s1","position":{"x":100,"y":200},"type":"start"},{"data":{"label":"Verification"},"id":"t1","position":{"x":300,"y":200},"type":"personTask"},{"data":{"label":"End"},"id":"e1","position":{"x":500,"y":200},"type":"end"}]}}},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VersionItemsOut":{"properties":{"checklistDefinitionVersionId":{"type":"string","format":"uuid","title":"Checklistdefinitionversionid","description":"Foreign key to workflow version (dbo.ChecklistDefinitionVersion.Id)."},"items":{"items":{"$ref":"#/components/schemas/ItemDefinitionOut"},"type":"array","title":"Items","description":"List of designer nodes stored in dbo.ItemDefinition with typed task configurations."},"routes":{"items":{"$ref":"#/components/schemas/ChecklistItemRouteOut"},"type":"array","title":"Routes","description":"List of directed edge transitions stored in dbo.ChecklistItemRoute."}},"type":"object","required":["checklistDefinitionVersionId","items","routes"],"title":"VersionItemsOut","description":"Complete version items and routes payload matching dbo.ItemDefinition and dbo.ChecklistItemRoute.","example":{"checklistDefinitionVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","items":[{"checklistDefinitionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","checklistDefinitionVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","createdAtUtc":"2026-10-19T10:00:00Z","executionMode":"Sequential","forms":[],"id":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","isEnabled":true,"itemType":"personTask","joinMode":"None","name":"Underwriter Review","nodeId":"6f1c7a52-31f4-4a43-9a43-2f1e1c2b7d10","nodeNumber":1,"nodeType":"Task","roles":[{"id":"4da78ef9-8132-4e89-b14a-10f7b587a82b","isEnabled":true,"roleId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","roleName":"Senior Underwriter","roleType":"Assignee"}],"rules":[],"splitMode":"None","subprocesses":[],"timers":[]}],"routes":[{"checklistDefinitionVersionId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","fromItemDefinitionId":"e8d4a92c-623b-4871-9c6a-48a03f47e3a1","id":"94cd5678-9abc-def0-1234-56789abcdef0","isDefault":true,"priority":0,"toItemDefinitionId":"b18da294-71ef-493b-c45e-99124632a63b"}]}},"WorkflowAIGenerateRequest":{"properties":{"prompt":{"type":"string","minLength":3,"title":"Prompt"}},"type":"object","required":["prompt"],"title":"WorkflowAIGenerateRequest"},"WorkflowMessageRequest":{"properties":{"message":{"type":"string","title":"Message","default":""},"workflowId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowid"},"selectedPhaseIds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Selectedphaseids"},"questionAnswers":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Questionanswers"},"selectedTemplateId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selectedtemplateid"},"editedWfJson":{"anyOf":[{},{"type":"null"}],"title":"Editedwfjson"}},"type":"object","title":"WorkflowMessageRequest"},"WorkflowMessageResponse":{"properties":{"instantMessage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instantmessage"},"actionTaken":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actiontaken"},"assistantReply":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assistantreply"},"workflowId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflowid"},"activePhaseId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activephaseid"},"affectedPhaseId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Affectedphaseid"},"phaseOptions":{"anyOf":[{"items":{"$ref":"#/components/schemas/PhaseOption"},"type":"array"},{"type":"null"}],"title":"Phaseoptions"},"phases":{"anyOf":[{"items":{"$ref":"#/components/schemas/Phase"},"type":"array"},{"type":"null"}],"title":"Phases"},"questions":{"anyOf":[{"items":{"$ref":"#/components/schemas/Question"},"type":"array"},{"type":"null"}],"title":"Questions"},"templateOptions":{"anyOf":[{"items":{"$ref":"#/components/schemas/TemplateOption"},"type":"array"},{"type":"null"}],"title":"Templateoptions"},"phaseUpdate":{"anyOf":[{"$ref":"#/components/schemas/PhaseUpdate"},{"type":"null"}]},"finalDiagram":{"anyOf":[{"$ref":"#/components/schemas/FinalDiagram"},{"type":"null"}]},"staleDownstream":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Staledownstream"},"savedWorkflowId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Savedworkflowid"}},"type":"object","title":"WorkflowMessageResponse"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"Internal service auth secret (e.g. wf_internal_...).","in":"header","name":"X-Internal-Auth"},"HTTPBearer":{"type":"http","description":"JWT Bearer token (issued by .NET authentication).","scheme":"bearer"},"AppId":{"type":"apiKey","description":"Application.Id GUID the request works in (required on /api data endpoints).","in":"header","name":"X-App-Id"}}},"tags":[{"name":"Workflows","description":"Lifecycle management of business workflow definitions: visual graph canvas authoring, versioning, checkouts, publishing, and retirement."},{"name":"Roles","description":"Participant performer roles, assignment matrices, and actor routing classifications."},{"name":"Teams","description":"Operational team structures, routing queues, and actor group associations."},{"name":"AI Workflows","description":"Multi-modal AI workflow generation, conversational message processing, dynamic phase sequence generation, and intent extraction."},{"name":"Workflow Library","description":"Seed workflow templates, pre-built operational blueprints, and reusable industry catalogs."},{"name":"Designer Assistant","description":"Interactive conversational design assistant for visual workflow editing, node modifications, and layout assembly."},{"name":"AI Notifications","description":"Intelligent notification generation, policy routing, and dynamic alert template synthesis."},{"name":"AI Research Agent","description":"Contextual domain research, regulatory compliance lookups, and industry policy analysis for workflows."},{"name":"Utilities","description":"Service operational runtime metrics, process uptime, and diagnostics."},{"name":"Health","description":"Service readiness, database connectivity, and ODBC driver diagnostics."}]}