Delete a custom task definition

DELETE

/agents/tasks/custom/{taskId}

Deletes a custom task you own. Global tasks (userId=null) cannot be deleted via this endpoint. Agents with this task enabled will no longer offer it on new calls. Use to clean up outdated or unused custom tasks.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/agents/tasks/custom/' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "id": "string",
    "slug": "schedule-appointment",
    "title": "Schedule Appointment",
    "description": "string",
    "completionCriteria": "string",
    "prerequisiteType": "calendar_connected",
    "groupName": "Scheduling",
    "userId": "string",
    "createdAt": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-07-23 18:02:16

Create a custom task definition

List call scenarios for an agent