Enable a task on an agent

POST

/agents/{id}/tasks/{taskId}/enable

Enables a task for the agent — creates the link if absent, updates priority if already enabled. The agent will offer this task during calls provided its prerequisites are met (e.g., calendar_connected requires a linked calendar). Priority defaults to 0.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/agents//tasks//enable' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "priority": 0
}'

Response Example

{
    "id": "string",
    "agentId": "string",
    "taskId": "string",
    "priority": 0,
    "createdAt": "2019-08-24T14:15:22.123Z",
    "task": {
        "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 enabled tasks for an agent

Disable a task on an agent