Submit a task
Use this resource to submit a specific task assigned to the authenticated user.
Request
To submit a task, send a POST request to the endpoint defined below.
URL: /task/submit/{taskId}
Method: POST
Authorization: required
POST /ibis/rest/task/submit/feaa6622-cee9-4158-94c7-eb7026b47477 HTTP/1.1
Accept: application/xml
Host: localhost:8080
Path Parameters
The following table lists the path parameters for this request.
| Name | Description | Required | Allowed values |
|---|---|---|---|
|
Enter the unique ID of the task. |
yes |
Alphanumeric with special character(-) |
|
Enter |
no |
|
|
Enter the process role that has the permission to submit the task. This parameter is required only if the submit action is performed independently without process user configuration. The roles must be sent in the request body. |
no |
Any role as string |
Response
The response indicates the success of the operation.
- 204
-
Task data successfully submitted.
- 201
-
Task data successfully submitted. For follow-up tasks, the ID of the next task is returned.
Errors
This request might return one of the following error codes:
- Client error locked (423)
-
If task is currently locked. Task needs to be unlocked before it can be changed.
- Authorization Failed (401)
-
Authorization with the given username and password failed. Please revisit both values and provide valid credentials.
<html>
<head>
<title>Status page</title>
</head>
<body style="font-family: sans-serif;">
<p style="font-size: 1.2em;font-weight: bold;margin: 1em 0px;">Unauthorized</p>
<p>The request requires user authentication</p>
<p>You can get technical details <a
href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2">here</a>.<br>
Please continue your visit at our <a href="/">home page</a>.
</p>
</body>
</html>
- Server Error (500)
-
Execution on the INUBIT server failed. Have a look into the response message, otherwise access to the INUBIT log is required to retrieve further information.
- Service Unavailable (503)
-
In maintenance mode the INUBIT server endpoint will not respond to incoming requests but return this error response. Once the maintenance mode is switched off the endpoint will respond normally.