List tasks
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).
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 for that).
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
Response Body
application/json
curl -X GET "https://example.com/c1/tasks"{ "statusCode": 200, "statusString": "OK", "values": { "stringList": { "values": [ "kstream_task_0:kafkastream-app", "kstream_task_1:kafkastream-app" ] } }}Create task POST
Register a new Task for the customer. This only persists the Task registration (name, type, params) — it does not start it. Use [Start task](/docs/api-reference/tasks/tasks-taskid-start-get) to actually launch the process. Currently the only known type is `kafkastream-app`. Its `params` map is passed straight through to the spawned process as JVM/config key-value pairs; the keys the server itself reads are: - `sml.kstream.rest` (`"true"`/`"false"`): if not `"true"`, a model must be supplied via one of `sml.kstream.model.b64` (base64 model string), `sml.kstream.model.b64file` (path to a file containing the base64 model), or the pair `sml.kstream.project.id` + `sml.kstream.model.id` (the server exports that model to a temp file for you). This is only checked when the task is **started**, not at creation time. - `sml.task.heap.min`: JVM heap size. Note this key is used for **both** `-Xms` and `-Xmx` (a source-level bug — there is no way to set the heap max independently right now; if omitted, `-Xms` defaults to `1024m` and `-Xmx` defaults to `2048m`, but if you set `sml.task.heap.min` at all, both flags get that same value).
Delete task DELETE
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.