POST api/workplan/{PlanId}/step/approve?state={state}&comment={comment}

Approve a Process Step
Request Information

URI Parameters

Name	Type	Additional information
PlanId	globally unique identifier	Required
state	ProcessState	Required
comment	string	Default value is
Body Parameters

None.
Response Information

Resource Description

WorkPlan
Name	Type	Additional information
Name	string	None.
Archived	boolean	None.
Author	globally unique identifier	None.
Created	date	None.
Modified	date	None.
Editor	globally unique identifier	None.
PlannerTypeId	globally unique identifier	None.
ParentPlanId	globally unique identifier	None.
PortfolioParentId	globally unique identifier	None.
PortfolioOrder	integer	None.
UserList	Collection of UserAccess	None.
InheritUserList	Collection of UserAccess	None.
TeamList	Collection of TeamAccess	None.
InheritTeamList	Collection of TeamAccess	None.
Fields	Dictionary of string [key] and Object [value]	None.
SummaryFields	Dictionary of string [key] and Object [value]	None.
Folder	boolean	None.
Fragment	boolean	None.
FragmentInfo	FragmentInfo	None.
Hidden	boolean	None.
Comments	Collection of TaskComment	None.
LastComment	date	None.
Integrations	Collection of IntegratedSystem	None.
Snapshots	Collection of FieldSnapshot	None.
SubPlans	Collection of globally unique identifier	None.
PlanNumber	string	None.
RateTables	Collection of PlanRateTable	None.
Splits	Collection of LookupSplit	None.
LockInfo	PlanLockInfo	None.
LastLocation	string	None.
StageGateFlow	StageGateFlow	None.
id	globally unique identifier	None.
ConfigId	globally unique identifier	None.
Response Formats

application/json, text/json

Sample:
{
  "Name": "sample string 1",
  "Archived": true,
  "Author": "d8f856ae-d532-4bdf-81dd-91d5ba82247c",
  "Created": "2025-10-19T09:14:19.9981933+00:00",
  "Modified": "2025-10-19T09:14:19.9981933+00:00",
  "Editor": "062321d4-82c2-4b66-b336-6ea62ddab547",
  "PlannerTypeId": "5ebbc424-5225-4564-8516-77b316c42e4a",
  "ParentPlanId": "40833e8d-6ce3-4f52-bfb7-6bc7f86eef4b",
  "PortfolioParentId": "9392ddbb-a698-4937-a98c-6b2c990334d6",
  "PortfolioOrder": 9,
  "UserList": [
    {},
    {}
  ],
  "InheritUserList": [
    {},
    {}
  ],
  "TeamList": [
    {},
    {}
  ],
  "InheritTeamList": [
    {},
    {}
  ],
  "Fields": {
    "sample string 1": {},
    "sample string 3": {}
  },
  "SummaryFields": {
    "sample string 1": {},
    "sample string 3": {}
  },
  "Folder": true,
  "Fragment": true,
  "FragmentInfo": {
    "Name": "sample string 1",
    "Description": "sample string 2",
    "Category": "sample string 3",
    "WorkTypes": "sample string 4",
    "Personal": true
  },
  "Hidden": true,
  "Comments": [
    {
      "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
      "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
      "PostDate": "2025-10-19T09:14:19.9981933+00:00",
      "Comment": "sample string 4",
      "CC": [
        "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
        "c55b6377-51e9-42dc-9787-7ec0c709f91e"
      ],
      "Users": [
        "ce276a24-c701-431c-949f-4b64427d2c89",
        "a58e6292-a410-441c-ab7b-bb1de0444fe1"
      ]
    },
    {
      "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
      "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
      "PostDate": "2025-10-19T09:14:19.9981933+00:00",
      "Comment": "sample string 4",
      "CC": [
        "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
        "c55b6377-51e9-42dc-9787-7ec0c709f91e"
      ],
      "Users": [
        "ce276a24-c701-431c-949f-4b64427d2c89",
        "a58e6292-a410-441c-ab7b-bb1de0444fe1"
      ]
    }
  ],
  "LastComment": "2025-10-19T09:14:19.9981933+00:00",
  "Integrations": [
    {
      "IntegrationId": "a1a25a12-5f2d-46ca-9e37-e5a5e58dbb98",
      "ItemUrl": "sample string 2",
      "ItemId": "sample string 3",
      "TransactionId": "27cf19a5-730f-43b7-88ed-c391f1347c5d",
      "LastExport": "2025-10-19T09:14:19.9981933+00:00",
      "LastImport": "2025-10-19T09:14:19.9981933+00:00",
      "IntegrationVersion": 7,
      "Properties": {
        "sample string 1": {},
        "sample string 3": {}
      }
    },
    {
      "IntegrationId": "a1a25a12-5f2d-46ca-9e37-e5a5e58dbb98",
      "ItemUrl": "sample string 2",
      "ItemId": "sample string 3",
      "TransactionId": "27cf19a5-730f-43b7-88ed-c391f1347c5d",
      "LastExport": "2025-10-19T09:14:19.9981933+00:00",
      "LastImport": "2025-10-19T09:14:19.9981933+00:00",
      "IntegrationVersion": 7,
      "Properties": {
        "sample string 1": {},
        "sample string 3": {}
      }
    }
  ],
  "Snapshots": [
    {
      "Date": "2025-10-19T09:14:19.9981933+00:00",
      "StatusReportId": "ccd2ce80-783a-4216-8f00-54f0b590080d",
      "Fields": {
        "sample string 1": {},
        "sample string 3": {}
      }
    },
    {
      "Date": "2025-10-19T09:14:19.9981933+00:00",
      "StatusReportId": "ccd2ce80-783a-4216-8f00-54f0b590080d",
      "Fields": {
        "sample string 1": {},
        "sample string 3": {}
      }
    }
  ],
  "SubPlans": [
    "1860cb54-1189-4326-abbe-7e376a739b09",
    "99d856c3-2ed7-4b1b-b205-bad88b9596ff"
  ],
  "PlanNumber": "sample string 14",
  "RateTables": [
    {
      "Id": "ddecdb99-b409-4d9d-8da2-a65e6524a09b",
      "Name": "sample string 2",
      "Multipliers": [
        {
          "Start": "2025-10-19T09:14:19.9981933+00:00",
          "End": "2025-10-19T09:14:19.9981933+00:00",
          "PercentRevenue": 3.0,
          "PercentCost": 4.0
        },
        {
          "Start": "2025-10-19T09:14:19.9981933+00:00",
          "End": "2025-10-19T09:14:19.9981933+00:00",
          "PercentRevenue": 3.0,
          "PercentCost": 4.0
        }
      ],
      "ResourceRates": [
        {
          "ResourceId": "d622c6f2-ce59-4230-ba54-44332d05d9f6",
          "BaseRate": 2.0
        },
        {
          "ResourceId": "d622c6f2-ce59-4230-ba54-44332d05d9f6",
          "BaseRate": 2.0
        }
      ]
    },
    {
      "Id": "ddecdb99-b409-4d9d-8da2-a65e6524a09b",
      "Name": "sample string 2",
      "Multipliers": [
        {
          "Start": "2025-10-19T09:14:19.9981933+00:00",
          "End": "2025-10-19T09:14:19.9981933+00:00",
          "PercentRevenue": 3.0,
          "PercentCost": 4.0
        },
        {
          "Start": "2025-10-19T09:14:19.9981933+00:00",
          "End": "2025-10-19T09:14:19.9981933+00:00",
          "PercentRevenue": 3.0,
          "PercentCost": 4.0
        }
      ],
      "ResourceRates": [
        {
          "ResourceId": "d622c6f2-ce59-4230-ba54-44332d05d9f6",
          "BaseRate": 2.0
        },
        {
          "ResourceId": "d622c6f2-ce59-4230-ba54-44332d05d9f6",
          "BaseRate": 2.0
        }
      ]
    }
  ],
  "Splits": [
    {
      "Field": "sample string 1",
      "Value": "c61222fe-1763-433a-97c0-2e30d9a20583",
      "Split": 3.0,
      "Values": {
        "sample string 1": 2.0,
        "sample string 3": 4.0
      }
    },
    {
      "Field": "sample string 1",
      "Value": "c61222fe-1763-433a-97c0-2e30d9a20583",
      "Split": 3.0,
      "Values": {
        "sample string 1": 2.0,
        "sample string 3": 4.0
      }
    }
  ],
  "LockInfo": {
    "LockedSid": "5207f33c-f138-4748-98b8-8ba3dc09613a",
    "LockedBy": "e8f980ee-8c93-4c66-a0c9-3adb0b147d83",
    "LockedDate": "2025-10-19T09:14:19.9981933+00:00"
  },
  "LastLocation": "sample string 15",
  "StageGateFlow": {
    "Id": "c1a43405-9f92-46ce-b4cd-36bf5aa16fc9",
    "CurrentGateId": "6ad56468-bace-482c-bb94-2d5521deec67",
    "EnteredGate": "2025-10-19T09:14:19.9981933+00:00",
    "ExitedGate": "2025-10-19T09:14:19.9981933+00:00",
    "GateClosed": true,
    "StepStarter": "1193f7f4-21a4-4307-86de-aa919fec58ec",
    "StepApprover": "a12436a2-6061-4efc-a9f6-db4e3e63ddc4",
    "ApprovalState": 0,
    "StepState": 0,
    "Comments": "sample string 8",
    "Approvals": [
      {
        "StepId": "0e067fae-a37c-4e27-9b6c-17b5cf3c6a59",
        "AutoApproved": true,
        "Completed": true,
        "Expired": true,
        "ExpiredReason": "sample string 5",
        "ApprovalStates": {
          "ea6ec6fa-e013-4ab1-a263-2093beb36744": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          },
          "7e01847e-34b9-41f0-a203-845a4e1ac412": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          }
        }
      },
      {
        "StepId": "0e067fae-a37c-4e27-9b6c-17b5cf3c6a59",
        "AutoApproved": true,
        "Completed": true,
        "Expired": true,
        "ExpiredReason": "sample string 5",
        "ApprovalStates": {
          "ea6ec6fa-e013-4ab1-a263-2093beb36744": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          },
          "7e01847e-34b9-41f0-a203-845a4e1ac412": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          }
        }
      }
    ],
    "ApprovalsLog": [
      {
        "StepId": "0e067fae-a37c-4e27-9b6c-17b5cf3c6a59",
        "AutoApproved": true,
        "Completed": true,
        "Expired": true,
        "ExpiredReason": "sample string 5",
        "ApprovalStates": {
          "ea6ec6fa-e013-4ab1-a263-2093beb36744": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          },
          "7e01847e-34b9-41f0-a203-845a4e1ac412": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          }
        }
      },
      {
        "StepId": "0e067fae-a37c-4e27-9b6c-17b5cf3c6a59",
        "AutoApproved": true,
        "Completed": true,
        "Expired": true,
        "ExpiredReason": "sample string 5",
        "ApprovalStates": {
          "ea6ec6fa-e013-4ab1-a263-2093beb36744": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          },
          "7e01847e-34b9-41f0-a203-845a4e1ac412": {
            "TaskId": "a7ca9519-afa8-43d4-952e-5b1ca4079369",
            "Status": 0,
            "Comments": [
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              },
              {
                "Id": "a790d50b-2e3d-4e1b-a2cd-045ac02da219",
                "UPN": "53298213-3c71-4f1f-970c-d3df8c707e8e",
                "PostDate": "2025-10-19T09:14:19.9981933+00:00",
                "Comment": "sample string 4",
                "CC": [
                  "3adbffb7-66ef-4c83-b1e4-b32c6f93e509",
                  "c55b6377-51e9-42dc-9787-7ec0c709f91e"
                ],
                "Users": [
                  "ce276a24-c701-431c-949f-4b64427d2c89",
                  "a58e6292-a410-441c-ab7b-bb1de0444fe1"
                ]
              }
            ]
          }
        }
      }
    ],
    "RulesRejected": [
      {
        "Id": "dc8ea865-c8c9-44ea-af15-975d8a400c24",
        "Name": "sample string 2",
        "FailureText": "sample string 3",
        "Filter": "sample string 4"
      },
      {
        "Id": "dc8ea865-c8c9-44ea-af15-975d8a400c24",
        "Name": "sample string 2",
        "FailureText": "sample string 3",
        "Filter": "sample string 4"
      }
    ],
    "ApprovalRejectionOrFailReason": "sample string 9"
  },
  "id": "b5ec811e-7cfd-4454-9555-bf20b6a99408",
  "ConfigId": "51a9e843-556a-4447-a2a9-25c31c5f2b61"
}