PRproductive
Task Lists

Update a task list

Changed on

Updates a task list. Only the provided attributes are modified — rename it or reassign it to a different folder via folder_id. To relocate a task list to a different project (which remaps task workflow statuses), use PATCH /task_lists/{id}/move instead.

patch/api/v2/task_lists/{id}

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/task_lists/{id}
  • Auth
    none declared

Path parameters

idstring required

ID

Request body

Example request

{
  "data": {
    "type": "task_lists",
    "attributes": {
      "name": "Sprint 5 (renamed)"
    }
  }
}

Response

Single task list

Example response

{
  "data": {
    "id": "14308",
    "type": "task_lists",
    "attributes": {
      "name": "Sprint 42",
      "position": 1,
      "placement": 1000000,
      "archived_at": null,
      "email_key": "a1b2c3d4e5f6789012345678901234ab"
    },
    "relationships": {
      "project": {
        "data": {
          "type": "projects",
          "id": "6899"
        }
      },
      "folder": {
        "data": {
          "type": "folders",
          "id": "5522"
        }
      }
    }
  },
  "included": []
}

Changes

  • fa3060fd0144Revision changes
    • warning

      added the new bad_decimal_format enum value to the // response property for the response status

    • warning

      added the new non_finite_number enum value to the // response property for the response status

    • warning

      added the new null_bytes_in_params enum value to the // response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 2eb527b17709Revision changes
    • info

      the request property // became optional

    • info

      the request property // became optional

    • info

      the request property // became optional