Initiate a task action submission

Deprecated

This endpoint is deprecated and may be removed in a future release.

This endpoint was deprecated on 2026-02-12.

It is scheduled for sunset on 2027-01-31.

Description

This endpoint enables submitting actions on a task. For tasks with multiple approval steps, it’s the only way to advance a task through the approval process.

POST /prototype/platform/tasks/{taskId}/actionSubmission

Required OAuth Scopes

task:write

Parameters

Parameter	In	Type	Required	Description
X-Version	header	string	false	Version of the API (2022-01-01)
taskId	path	string	true	The unique identifier of the task
body	body	PrototypeTaskAction	true	The action to be applied on the task.

Body parameter example

{
  "action": "APPROVE",
  "comment": "please refine"
}

Code Samples

curl

curl -X POST https://api.app.wdesk.com/prototype/platform/tasks/{taskId}/actionSubmission \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2022-01-01'

httpie

http POST https://api.app.wdesk.com/prototype/platform/tasks/{taskId}/actionSubmission \
    X-Version:2022-01-01 \
    Content-Type:application/json \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=POST "https://api.app.wdesk.com/prototype/platform/tasks/{taskId}/actionSubmission" \
    --output-document -  \ 
    --header 'Content-Type: application/json' \ 
    --header 'Accept: application/json' \ 
    --header 'Authorization: Bearer {access-token}' \
    --header 'X-Version: 2022-01-01'

python

import requests

headers = {
  'X-Version': '2022-01-01',
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api.app.wdesk.com/prototype/platform/tasks/{taskId}/actionSubmission', headers = headers)

print(r.json())

Returns

200 - OK

Details about the task, including its title, description, type, deadlines, participants, and additional metadata. Please note that the Task object has been updated to accommodate the new task approval process which results in breaking changes to the Tasking endpoints. Some fields like assignee and approvers have been removed, and new fields like approvalSteps have been added. The status field can now only be updated for tasks with a single approval step. For a task with multiple approval steps, the status field will be updated automatically when actions are taken on the task. See the endpoint Submit Task Action for more details.

Example Responses

200 Response

{
  "approvalSteps": [
    {
      "completionMode": "ONE",
      "dueAt": null,
      "participants": [
        {
          "id": "V0ZVc2VyHzY0MTI5NzM0MzkxODg5OTI",
          "type": "USER"
        },
        {
          "id": "V0ZVc2VyHzU0MDg3OTc0MDE4MDg4OTY",
          "type": "USER"
        }
      ],
      "responses": [
        {
          "action": "REJECT",
          "comment": "please refine",
          "created": {
            "dateTime": "2023-06-11T13:00:00+00:00",
            "user_id": "V0ZVc2VyHzU0MDg3OTc0MDE4MDg4OTY"
          }
        }
      ]
    }
  ],
  "assignees": [
    {
      "id": "V1ZVd2VyFzU3NiQ1NDA4NjIzNzk2MjD",
      "type": "USER"
    }
  ],
  "created": {
    "dateTime": "2019-10-29T15:03:27Z"
  },
  "description": "Review document for spelling and grammar",
  "dueAt": "2019-10-30T00:00:00Z",
  "id": "VGFzax41MWNmOGZjMDQxMzc1MmRlYWZjMTA2ZjgyMzJiNDllZg",
  "modified": {
    "dateTime": "2019-10-29T15:03:27Z"
  },
  "sourceUrl": "https://app.wdesk.com/tasks/d/UVdOauIzVaVkQjdxTmzNNUOEUTQOakEnTnpJTE9ENXkuEkdGeaF4OENNJEV3NUTBmA?token=NTc0NDU2MTg1MjM0ODUyTM",
  "status": "Awaiting Approval",
  "title": "Review Document"
}