Delete task
Stop the Task's process if it's currently running (same effect as [Stop task](/docs/api-reference/tasks/tasks-taskid-stop-get)) and permanently remove its registration. To start it again later you'd need to [Create task](/docs/api-reference/tasks/tasks-create-post) again from scratch.
Stop the Task's process if it's currently running (same effect as Stop task) and permanently remove its registration. To start it again later you'd need to Create task again from scratch.
Authorization
SymetryMLAuth HMAC-SHA256 signature-based authentication: requests are signed with
your secret key and sent with the Customer-ID, Sym-date,
Authorization, Content-MD5 and sym-version headers.
See SymetryML REST API Security
for the signature algorithm and a complete example.
In: header
Path Parameters
User/Customer identifier
Task name (used as its identifier)
Response Body
application/json
application/json
curl -X DELETE "https://example.com/c1/tasks/kstream_task_0"{ "statusCode": 200, "statusString": "OK", "values": {}}{ "statusCode": 400, "statusString": "Customer [c1] has no Task [nosuchtask]", "values": {}}List tasks GET
List every Task registered for the customer, as `"name:type"` strings. This reflects only the persisted registration — it does not indicate whether a Task's process is currently running (see [Get task status](/docs/api-reference/tasks/tasks-taskid-get) for that).
Get task status GET
Get the current runtime status of a Task's process. Only meaningful after the Task has been started via [Start task](/docs/api-reference/tasks/tasks-taskid-start-get) — the running-task registry is an in-memory map on the server, not persisted, so this reports `"not running"` both for a Task that was never started and for one that was running before the last server restart. `lastError` is misleadingly named — for a `kafkastream-app` task it's just the last line the process wrote to stderr, which routinely includes benign Kafka consumer-group rebalance `INFO` lines even while the task is healthy and `processIsAlive` is `"true"`. Don't treat a non-null `lastError` as proof the Task failed.