engTaskTemplate resource type

Use the "engTaskTemplate" API to manage reusable engineering task template headers. Template lines are documented separately in engTaskTemplateLine. Templates can be applied to ECOs via ECO actions.

API version: v2.0
Publisher: cosmoconsult
Group: productdatamanagement
Base (SaaS): https://api.businesscentral.dynamics.com/v2.0/{tenant}/Production/api/cosmoconsult/productdatamanagement/v2.0
Base (On‑Prem): https://{host}/{container}rest/api/cosmoconsult/productdatamanagement/v2.0
Metadata: {Base}/$metadata?tenant=default&$schemaversion=2.0

Permissions

Requires access to the target company and permissions to read/write templates.

Methods

Operation	Company‑scoped	Unscoped
List templates	GET /companies({companyId})/engTaskTemplates	GET /engTaskTemplates
Create template	POST /companies({companyId})/engTaskTemplates	POST /engTaskTemplates
Get template	GET /companies({companyId})/engTaskTemplates({id})	GET /engTaskTemplates({id})
Update template	PATCH /companies({companyId})/engTaskTemplates({id})	PATCH /engTaskTemplates({id})
Delete template	DELETE /companies({companyId})/engTaskTemplates({id})	DELETE /engTaskTemplates({id})

Line operations are documented in the engTaskTemplateLine resource page.

Endpoints

Company‑scoped

GET/POST /companies({companyId})/engTaskTemplates
GET/PATCH/DELETE /companies({companyId})/engTaskTemplates({id})
GET/POST /companies({companyId})/engTaskTemplates({id})/engTaskTemplateLines (navigation to lines)
GET/PATCH/DELETE /companies({companyId})/engTaskTemplates({id})/engTaskTemplateLines({lineId})

Unscoped

GET/POST /engTaskTemplates
GET/PATCH/DELETE /engTaskTemplates({id})
GET/POST /engTaskTemplates({id})/engTaskTemplateLines (navigation to lines)
GET/PATCH/DELETE /engTaskTemplates({id})/engTaskTemplateLines({lineId})

Direct line entity set endpoints are documented in engTaskTemplateLine.

Query Options

$select, $filter, $orderby, $expand, $top, $skip

Request Headers

Authorization: Bearer {token}
Content-Type: application/json (POST/PATCH)
If-Match: {etag} (required for PATCH)

Key Properties (Template Head)

id (SystemId, GUID)
code
description
lastModifiedDateTime (read‑only)

Notes

Apply templates to an ECO via ECO actions:

POST {Base}/companies({companyId})/engChangeOrders({ecoId})/Microsoft.NAV.applyTaskTemplateByCode
POST {Base}/companies({companyId})/engChangeOrders({ecoId})/Microsoft.NAV.applyTaskTemplate

Examples

Create template head: POST {Base}/companies({companyId})/engTaskTemplates { "code": "TMPL001", "description": "Sample ECO tasks" }
Apply to ECO (on engChangeOrder): POST {Base}/companies({companyId})/engChangeOrders({ecoId})/Microsoft.NAV.applyTaskTemplateByCode { "engTaskTemplateCode": "TMPL001" }

Further line examples are in engTaskTemplateLine.