Skip to main content

Tasks

The organization's executable skills: registration, run, pre-check and the HTTP run endpoint.

CommandHTTPDescription
tasks listGET /v1/tasksList tasks
tasks createPOST /v1/tasksCreate task
tasks getGET /v1/tasks/{id}Get task details
tasks updatePATCH /v1/tasks/{id}Update task
tasks deleteDELETE /v1/tasks/{id}Delete tasks (soft delete)
tasks runPOST /v1/tasks/{id}/runRun task
tasks endpoint getGET /v1/tasks/{id}/endpointTask HTTP run endpoint
tasks endpoint updatePUT /v1/tasks/{id}/endpointConfigure the Task's HTTP endpoint
tasks endpoint deleteDELETE /v1/tasks/{id}/endpointDisable the Task's HTTP endpoint
tasks readinessGET /v1/tasks/{id}/readinessRun pre-check

Examples​

--params carries query and path parameters (id, page, filters); --json carries the request body; --fields limits the fields that come back — worth using on every list/get to save context. See Global flags for the full reference.

# List tasks
kobana kadu tasks list --fields "id"

# Create task
kobana kadu tasks create \
--json '{"label": "LABEL", "workspace_id": "WORKSPACE_ID", "activity_id": "ACTIVITY_ID", "skill_slug": "finance:task-baixar-pagamentos-via-boleto-pix"}'

# Get task details
kobana kadu tasks get --params '{"id": "TASK_ID"}'

# Update task
kobana kadu tasks update --params '{"id": "TASK_ID"}'

# Delete tasks (soft delete)
kobana kadu tasks delete \
--params '{"id": "TASK_ID"}' \
--dry-run

# Run task
kobana kadu tasks run \
--params '{"id": "TASK_ID"}' \
--json '{"reference_date": "2026-10-30", "environment_id": "ENVIRONMENT_ID"}' \
--dry-run

# Task HTTP run endpoint
kobana kadu tasks endpoint get --params '{"id": "TASK_ID"}'

# Configure the Task's HTTP endpoint
kobana kadu tasks endpoint update \
--params '{"id": "TASK_ID"}' \
--json '{"enabled": true, "auth": "basic"}'

# Disable the Task's HTTP endpoint
kobana kadu tasks endpoint delete \
--params '{"id": "TASK_ID"}' \
--dry-run

# Run pre-check
kobana kadu tasks readiness --params '{"id": "TASK_ID"}'

Next steps​