Create a custom task definition

POST

/agents/tasks/custom

Defines a user-scoped task (only visible to you) with title, description, and completion criteria. Custom tasks can then be enabled on any of your agents. Use when the global task library doesn't cover a niche objective specific to your business.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/agents/tasks/custom' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "title": "Collect insurance info",
    "description": "Ask the caller for their insurance provider",
    "completionCriteria": "Insurance info is collected",
    "groupName": "Custom"
}'

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

List all tasks available to user (global + custom)

Delete a custom task definition