Help Center/ CodeArts PerfTest/ API Reference/ API/ Task Management/ This API is used to delete a task.
Updated on 2026-02-09 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

This API is used to delete a task.

Function

Deleting a Task

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    codeartsperftest:cpts:deletePerfTestTask

    Write

    cpts *

    g:ResourceTag/<tag-key>

    -

    -

URI

DELETE /v3/{project_id}/tasks/{task_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details, see Method of obtaining instructions.

task_id

Yes

Integer

Task ID, which is the value of task_id in the response body of the API for creating a task.

Request Parameters

None

Response Parameters

Status code: 204

The task is deleted successfully.

None

Example Requests

Deleting a task whose ID is 1.

/v3/{project_id}/tasks/1

Example Responses

None

Status Codes

Status Code

Description

204

The task is deleted successfully.

Error Codes

See Error Codes.

Parent topic: Task Management