Group Resource Options
The /group
resource supports two custom OPTIONS requests, one for the resource as such and one for individual group instances. The OPTIONS request allows checking for the set of available operations that the currently authenticated user can perform on the /group
resource. If the user can perform an operation or not may depend on various things, including the users authorizations to interact with this resource and the internal configuration of the process engine.
Method
OPTIONS /group
for available interactions on resource.
OPTIONS /group/{id}
for available interactions on resource instance.
Parameters
Path Parameters
Name | Description |
---|---|
id | The id of the group. |
Result
A JSON object with a single property named links
, providing a list of resource links. Each link has the following properties
Name | Type | Description |
---|---|---|
method | String | The HTTP method to use for the interaction. |
href | String | The interaction URL. |
rel | String | The relation of the interaction (i.e., a symbolic name representing the nature of the interaction). Examples: create , delete ... |
Response Codes
Code | Media type | Description |
---|---|---|
200 | application/json | Request successful. |
Example 1
Request
OPTIONS /group
Response
Status 200.
{"links":[
{"method":"GET","href":"http://localhost:8080/camunda/api/engine/engine/default/group","rel":"list"},
{"method":"GET","href":"http://localhost:8080/camunda/api/engine/engine/default/group/count","rel":"count"},
{"method":"POST","href":"http://localhost:8080/camunda/api/engine/engine/default/group/create","rel":"create"}]}
Example 2
Request
OPTIONS /group/aGroupId
Response
Status 200.
{"links":[
{"method":"GET","href":"http://localhost:8080/camunda/api/engine/engine/default/group/aGroupId","rel":"self"},
{"method":"DELETE","href":"http://localhost:8080/camunda/api/engine/engine/default/group/aGroupId","rel":"delete"},
{"method":"PUT","href":"http://localhost:8080/camunda/api/engine/engine/default/group/aGroupId","rel":"update"}]}