Skip to navigation

Delete a task

View as Markdown

Delete a task. Returns an empty object on success.

Deleting your own tasks and deleting other users' tasks need separate permissions. Returns 400 if you don't have the one this task needs, 403 if the task is on a lead you can't see, and 404 if no task has this ID.

Authentication

AuthorizationBasic
Use your API key as the username and leave the password empty.
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

ID of the task, e.g. task_aRUZXCm9lMb2LwipTPhfFoFbCsUnaoQh1ncQ7WLnjlI.

Response

Successful response

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error