orvanta-api 6.3.0

No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
# \CmmnApi

All URIs are relative to */api*

Method | HTTP request | Description
------------- | ------------- | -------------
[**archive_cmmn_case_by_path**](CmmnApi.md#archive_cmmn_case_by_path) | **POST** /w/{workspace}/cmmn_cases/archive/{path} | archive CMMN case model by path
[**close_cmmn_case_instance**](CmmnApi.md#close_cmmn_case_instance) | **POST** /w/{workspace}/cmmn/instances/close/{id} | close a finished CMMN case instance
[**create_cmmn_case**](CmmnApi.md#create_cmmn_case) | **POST** /w/{workspace}/cmmn_cases/create | create CMMN case model
[**delete_cmmn_case_by_path**](CmmnApi.md#delete_cmmn_case_by_path) | **DELETE** /w/{workspace}/cmmn_cases/delete/{path} | delete CMMN case model by path
[**exists_cmmn_case_by_path**](CmmnApi.md#exists_cmmn_case_by_path) | **GET** /w/{workspace}/cmmn_cases/exists/{path} | exists CMMN case model by path
[**get_cmmn_case**](CmmnApi.md#get_cmmn_case) | **GET** /w/{workspace}/cmmn/instances/get/{id} | get CMMN case instance
[**get_cmmn_case_by_path**](CmmnApi.md#get_cmmn_case_by_path) | **GET** /w/{workspace}/cmmn_cases/get/{path} | get CMMN case model by path
[**get_cmmn_case_by_path_with_draft**](CmmnApi.md#get_cmmn_case_by_path_with_draft) | **GET** /w/{workspace}/cmmn_cases/get/draft/{path} | get CMMN case model by path with draft
[**get_cmmn_case_history**](CmmnApi.md#get_cmmn_case_history) | **GET** /w/{workspace}/cmmn_cases/history/p/{path} | get CMMN case model history by path
[**get_cmmn_case_overview**](CmmnApi.md#get_cmmn_case_overview) | **GET** /w/{workspace}/cmmn_cases/overview/v/{version} | get the stage overview and case pages for a deployed case-model version
[**get_cmmn_case_status**](CmmnApi.md#get_cmmn_case_status) | **GET** /w/{workspace}/cmmn/instances/get/{id}/status | get CMMN case instance status
[**list_cmmn_case_instances**](CmmnApi.md#list_cmmn_case_instances) | **GET** /w/{workspace}/cmmn/instances/list | list CMMN case instances
[**list_cmmn_cases**](CmmnApi.md#list_cmmn_cases) | **GET** /w/{workspace}/cmmn_cases/list | list all CMMN case models
[**resume_cmmn_case_instance**](CmmnApi.md#resume_cmmn_case_instance) | **POST** /w/{workspace}/cmmn/instances/resume/{id} | resume a suspended CMMN case instance
[**start_cmmn_case**](CmmnApi.md#start_cmmn_case) | **POST** /w/{workspace}/cmmn/run/p/{path} | start CMMN case instance
[**suspend_cmmn_case_instance**](CmmnApi.md#suspend_cmmn_case_instance) | **POST** /w/{workspace}/cmmn/instances/suspend/{id} | suspend a running CMMN case instance
[**terminate_cmmn_case_instance**](CmmnApi.md#terminate_cmmn_case_instance) | **POST** /w/{workspace}/cmmn/instances/terminate/{id} | terminate a running CMMN case instance
[**trigger_cmmn_plan_item**](CmmnApi.md#trigger_cmmn_plan_item) | **POST** /w/{workspace}/cmmn/instances/{id}/plan-items/{plan_item_id}/{transition} | apply a transition to one plan item of a running CMMN case
[**update_cmmn_case**](CmmnApi.md#update_cmmn_case) | **POST** /w/{workspace}/cmmn_cases/update/{path} | update CMMN case model



## archive_cmmn_case_by_path

> String archive_cmmn_case_by_path(workspace, path, archive_flow_by_path_request)
archive CMMN case model by path

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |
**archive_flow_by_path_request** | [**ArchiveFlowByPathRequest**](ArchiveFlowByPathRequest.md) | archive CMMN case model | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## close_cmmn_case_instance

> String close_cmmn_case_instance(workspace, id)
close a finished CMMN case instance

The CMMN 1.1 case-instance transition out of `completed` or `terminated`. Unlike suspend/resume/terminate this is applied immediately rather than through the control channel: a finished case's queue row has been completed, so no worker would ever read it. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **uuid::Uuid** |  | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## create_cmmn_case

> models::CmmnDeployResult create_cmmn_case(workspace, new_cmmn_case_model)
create CMMN case model

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**new_cmmn_case_model** | [**NewCmmnCaseModel**](NewCmmnCaseModel.md) | CMMN case model to create | [required] |

### Return type

[**models::CmmnDeployResult**](CmmnDeployResult.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## delete_cmmn_case_by_path

> String delete_cmmn_case_by_path(workspace, path)
delete CMMN case model by path

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## exists_cmmn_case_by_path

> bool exists_cmmn_case_by_path(workspace, path)
exists CMMN case model by path

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

**bool**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_cmmn_case

> models::CmmnCaseDetail get_cmmn_case(workspace, id)
get CMMN case instance

The persisted runtime state of one case instance — the engine's own `CaseInstance` (plan-item instances, their lifecycle states, sentry latches, case variables, transition history) plus the job-level lifecycle, incidents, the waiting set and the control channel.  `case_status` is `null` in the window between the job being pushed and its first step committing, so a freshly started case can legitimately return `200` with no engine state yet. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **uuid::Uuid** |  | [required] |

### Return type

[**models::CmmnCaseDetail**](CmmnCaseDetail.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_cmmn_case_by_path

> models::CmmnCaseModel get_cmmn_case_by_path(workspace, path)
get CMMN case model by path

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

[**models::CmmnCaseModel**](CmmnCaseModel.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_cmmn_case_by_path_with_draft

> models::CmmnCaseModelWithDraft get_cmmn_case_by_path_with_draft(workspace, path)
get CMMN case model by path with draft

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

[**models::CmmnCaseModelWithDraft**](CmmnCaseModelWithDraft.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_cmmn_case_history

> Vec<models::CmmnCaseModelVersion> get_cmmn_case_history(workspace, path)
get CMMN case model history by path

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

[**Vec<models::CmmnCaseModelVersion>**](CmmnCaseModelVersion.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_cmmn_case_overview

> models::CmmnCaseOverview get_cmmn_case_overview(workspace, version)
get the stage overview and case pages for a deployed case-model version

The stage rail and the case-page list `orvanta_cmmn::stage_overview` and `orvanta_cmmn::case_pages` derive from one deployed document.  **By version, not by path**, and that is half the point. A running case pins a `cmmn_case_model_version.id` and resolves its model from that row on every step, while `GET /cmmn_cases/get/{path}` returns whatever is deployed *now* — a different document the moment anyone redeploys. A Case View reading the latest can only warn that its rail might not match; reading the pinned version makes the warning unnecessary.  The ACL comes from the parent `cmmn_case_model` row: the version table has no RLS and no `extra_perms` of its own, so the read joins the parent and `cmmn_cases:read:<path>` is checked on the path the join returned, not on one the caller supplied. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**version** | **i64** | a `cmmn_case_model_version.id` | [required] |

### Return type

[**models::CmmnCaseOverview**](CmmnCaseOverview.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_cmmn_case_status

> models::CmmnCaseInstanceStatus get_cmmn_case_status(workspace, id)
get CMMN case instance status

Everything the Case View re-reads on its 1s poll, and nothing else.  **The trace is absent by construction, not empty.** This response has no `history` field at all rather than an emptied one, because a `[]` a reader could mistake for \"this case has done nothing\" is exactly the silent shape this codebase keeps unwinding. `history_len` says how many events the full document carries, so a client can tell \"no trace here\" from \"no trace yet\" without fetching it — use `GET /cmmn/instances/get/{id}` for the trace itself.  `case_state` / `lifecycle` are `null` in the window between the job being pushed and its first step committing. That is a `200`, not a `404`: the row exists and the poll must keep going. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **uuid::Uuid** |  | [required] |

### Return type

[**models::CmmnCaseInstanceStatus**](CmmnCaseInstanceStatus.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## list_cmmn_case_instances

> Vec<models::CmmnCaseSummary> list_cmmn_case_instances(workspace, page, per_page, business_key)
list CMMN case instances

Case instances for the workspace, newest first, as cheap columns only. Root `cmmn_case` jobs (`parent_job IS NULL`) — a case's own child jobs are not case instances.  `business_key` is a **server-side** filter over `cmmn_case_status.business_key` (case-insensitive substring), which is what makes a case on page three findable from page one.  `lifecycle` and `case_state` are read straight out of the JSONB rather than by deserialising the engine blob, so a page of thirty rows costs thirty column reads and not thirty case documents. Both are reported because they can legitimately disagree: an `active` case may carry an `incident`. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**page** | Option<**i32**> | which page to return (start at 1, default 1) |  |
**per_page** | Option<**i32**> | number of items to return for a given page (default 30, max 100) |  |
**business_key** | Option<**String**> | case-insensitive substring match on the #199 business key. An empty value is no filter, not a match on the empty string.  |  |

### Return type

[**Vec<models::CmmnCaseSummary>**](CmmnCaseSummary.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## list_cmmn_cases

> Vec<models::ListableCmmnCaseModel> list_cmmn_cases(workspace, page, per_page, path_start, show_archived, include_draft_only, with_cmmn_xml)
list all CMMN case models

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**page** | Option<**i32**> | which page to return (start at 1, default 1) |  |
**per_page** | Option<**i32**> | number of items to return for a given page (default 30, max 100) |  |
**path_start** | Option<**String**> | mask to filter matching starting path |  |
**show_archived** | Option<**bool**> |  |  |
**include_draft_only** | Option<**bool**> |  |  |
**with_cmmn_xml** | Option<**bool**> | (default false) Include each model's deployed `cmmn_xml` on the list row, so a caller that draws every model (a thumbnail grid, which reads the document's own `CMMNDI` geometry) does not need one `getCmmnCaseByPath` per item.  Opt-in because it is by far the largest thing in the row. Limited to `per_page` <= 100; a larger page with this flag set is refused with 400 rather than silently clamped.  |  |

### Return type

[**Vec<models::ListableCmmnCaseModel>**](ListableCmmnCaseModel.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## resume_cmmn_case_instance

> String resume_cmmn_case_instance(workspace, id)
resume a suspended CMMN case instance

Every suspended plan item takes `parentResume` back to the state it held when the case was suspended — not `available`, which would re-activate a stage and duplicate its children — and the case becomes `active` again. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **uuid::Uuid** |  | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## start_cmmn_case

> String start_cmmn_case(workspace, path, start_cmmn_case)
start CMMN case instance

Pushes a `CmmnCase` job for the latest deployed version at `path` and returns its id, which is also the case-instance id.  Only a **deployed** model can be started: the lookup spells `draft_only IS NOT TRUE`, so a path that exists only as a draft 404s exactly as an absent one does. A draft was never parsed and never admitted, so starting one would hand the worker a model nothing checked. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |
**start_cmmn_case** | [**StartCmmnCase**](StartCmmnCase.md) | start variables, and an optional | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## suspend_cmmn_case_instance

> String suspend_cmmn_case_instance(workspace, id)
suspend a running CMMN case instance

Every live plan item takes `parentSuspend` and the case becomes `suspended`: no criteria are evaluated, no completion is decided and plan-item triggers are refused until it is resumed. The request is parked in the case's control channel and applied by the worker on its next step. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **uuid::Uuid** |  | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## terminate_cmmn_case_instance

> String terminate_cmmn_case_instance(workspace, id)
terminate a running CMMN case instance

Every live plan item takes `terminate`, deepest first, and the case becomes `terminated`. Distinct from an exit criterion on the case plan model, which emits `exit` instead — both land in `terminated`, so only the recorded history tells them apart. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **uuid::Uuid** |  | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## trigger_cmmn_plan_item

> String trigger_cmmn_plan_item(workspace, id, plan_item_id, transition, instance)
apply a transition to one plan item of a running CMMN case

Completing a human task, firing a user event listener, manually starting an item — one [`CmmnTriggerIntent`] written into the case's control channel and applied by the worker on its next step. The engine decides legality; this route decides who may ask.  ## Which transitions  `Complete`, `Occur`, `ManualStart`, `Disable`, `Reenable` — exactly the set the engine can put into `CmmnWaitingItem.accepts`, so a client passes back verbatim what it was offered. The spelling in the path is the **Rust variant name** (`ManualStart`), which is how `accepts` serialises, not the CMMN `<standardEvent>` spelling (`manualStart`).  Everything else is a `400` naming why. Notably `Fault` is never requestable — a fault is raised by a behaviour and never asked for, and making it requestable would let a caller fabricate a failure the engine never observed. Per-plan-item `Terminate` / `Suspend` / `Resume` are drivable by the engine but are operator authority over one item rather than participation in it; the case-level routes above are the operator surface today.  ## Which instance  `?instance=` names one entry of `CmmnCaseInstance.instances`. Omitting it is the ordinary case and it is resolved server-side. It becomes **required** the moment a plan item has more than one instance parked — a `repetitionRule` produces one per repetition, each separately completable, and picking one arbitrarily is the defect BPMN's #1275 named. The `400` lists the candidates.  ## Who may ask  `cmmn_cases:write:instances`, the instance must be visible under the caller's own row-level ACLs, **and** the plan item's declared audience must admit them. The audience is derived from the model by the same `HumanTaskAudience::permits` predicate BPMN's user tasks use (#1123): admins always; a task that declares nobody falls back to instance visibility; a literal `flowable:assignee` / `owner` / `candidateUsers` / `candidateGroups` is matched on username or group; and a declared identity this build cannot resolve — an `${expression}`, or a `performerRef` / `authorizedRoleRefs` naming a `<caseRoles>` role that `orvanta-cmmn` does not model — falls **open**, because hiding a task nobody can be shown to own is the defect #1104 fixed. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **uuid::Uuid** |  | [required] |
**plan_item_id** | **String** | the `<planItem>` id, as reported by `CmmnWaitingItem.plan_item_id` | [required] |
**transition** | **String** | one of the transitions `CmmnWaitingItem.accepts` can contain. Any other `CmmnPlanItemTransition` is a 400.  | [required] |
**instance** | Option<**i32**> | index into `CmmnCaseInstance.instances`, as reported by `CmmnWaitingItem.instance`. Required only when the plan item has more than one instance parked.  |  |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## update_cmmn_case

> models::CmmnDeployResult update_cmmn_case(workspace, path, new_cmmn_case_model)
update CMMN case model

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |
**new_cmmn_case_model** | [**NewCmmnCaseModel**](NewCmmnCaseModel.md) | CMMN case model to update. A `path` differing from the one in the URL renames the model: the model row and its whole version history move together, so a running case's pinned version still resolves (#1343).  | [required] |

### Return type

[**models::CmmnDeployResult**](CmmnDeployResult.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)