Add a Subproject with REST API

Products

• Clarity PPM SaaS
• Clarity PPM On Premise

Issue/Introduction

 You are looking for a way to update new projects to be a subproject to a master that is existing in the system with REST API import. 

Environment

All Supported Clarity Releases

Resolution

• Adding subprojects works with REST API.
• You have to use this Request URL (ID is example):
• http://SERVERNAME/ppm/rest/v1/projects/5001000/tasks
• then include the subproject details and ID.
•    "subProjectId": 5020026

Example: 

• Master Project in the system : 5001000, PR2000, master_test
• Sub: 5020026, test_sub, Test Sub
• Once 5020026 is created, add a new request to POST on http://SERVERNAME/ppm/rest/v1/projects/5001000/tasks

{
    "investmentCode": "PR2000",
    "subProjectId": 5020026,
    "subProjectTaskId": null,
    "_internalId": 5048002,
    "_self": "http://SERVERNAME/ppm/rest/v1/projects/5001000/tasks/5048002",
    "isTaskAssignedToRes": false,
    "isTask": false,
    "createdDate": "2025-10-17T10:48:41",
    "hasAssignments": false,
    "wbsSort": 1,
    "finishDate": "2024-08-05T17:00:00",
    "parentTaskName": null,
    "hasSubtasks": false,
    "nextSibling": 5048000,
    "origEarlyStartDate": null,
    "hasConversations": false,
    "investmentApiAlias": "projects",
    "lastUpdatedBy": "Administrator, PPM",
    "isMilestone": false,
    "investmentName": "master test",
    "_parentId": 5001000,
    "name": "Test Sub",
    "isOpenForTE": true,
    "code": "test_sub",
    "taskOwner": null,
    "parentTaskId": null,
    "_parent": "http://SERVERNAME/ppm/rest/v1/projects/5001000",
    "investmentManagerID": {
        "displayValue": "Administrator, PPM",
        "_type": "lookup",
        "id": "1"
    },
    "lastUpdatedDate": "2025-10-17T10:48:41",
    "createdBy": "Administrator, PPM"
}