Get one decision of a past evaluation
HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("http://localhost:8080/v2/decision-instances/2251799813684367-1")) .header("Authorization", "Bearer <token>") .method("GET", HttpRequest.BodyPublishers.noBody()) .build();HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());System.out.println(response.body());const url = 'http://localhost:8080/v2/decision-instances/2251799813684367-1';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url http://localhost:8080/v2/decision-instances/2251799813684367-1 \ --header 'Authorization: Bearer <token>'One decision instance with what it evaluated: its inputs and the
rules that matched, each rule’s outputs. A malformed key is 400; a
key the tenant has no decision instance for, or one of a decision the
caller may not read, is 404.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”<decisionEvaluationKey>-<position>, the position counted from 1.
Header Parameters
Section titled “Header Parameters”Tenant selection. A principal bound to one tenant may omit it; if
sent, it must equal that tenant (403 otherwise). A principal that
may act in several tenants must send it on every request:
without it the request is refused with 400, and a tenant it may
not act in is refused with 403.
Responses
Section titled “ Responses ”The decision instance.
object
Part of the wire shape. This release always sends null.
Positive signed 64-bit entity key, written as a decimal string.
The decision’s name; empty when the model gives none.
The decision’s version; -1 for a required decision that failed before the evaluation described it.
Positive signed 64-bit entity key, written as a decimal string.
An RFC 3339 timestamp.
Why the evaluation failed
The decision’s output as JSON text (null for a decision that failed).
Positive signed 64-bit entity key, written as a decimal string.
The decision table’s inputs as they were evaluated (none for a literal expression).
object
JSON text.
object
From 1.
object
JSON text.
Example
{ "decisionDefinitionKey": "2251799813685249", "decisionDefinitionType": "DECISION_TABLE", "decisionEvaluationKey": "2251799813685249", "elementInstanceKey": "2251799813685249", "processDefinitionKey": "2251799813685249", "processInstanceKey": "2251799813685249", "rootDecisionDefinitionKey": "2251799813685249", "rootProcessInstanceKey": "2251799813685249", "state": "EVALUATED"}The request is malformed, or it uses a property or filter this release does not support.
An RFC 9457 problem document. type is a stable TinyConductor URN.
object
The request path.
Present only on mode-not-supported. It names the engine’s mode.
Example
{ "type": "urn:bpm:error:invalid-argument", "title": "Bad Request", "status": 400, "detail": "entity key must be a positive int64 string", "instance": "/v2/process-instances/0"}No valid credential was presented.
An RFC 9457 problem document. type is a stable TinyConductor URN.
object
The request path.
Present only on mode-not-supported. It names the engine’s mode.
Example
{ "type": "urn:bpm:error:unauthorized", "title": "Unauthorized", "status": 401, "detail": "A valid bearer credential is required", "instance": "/v2/decision-instances/2251799813685262"}Headers
Section titled “Headers”The caller lacks the required permission, a tenant named in the request is not the caller’s tenant, or a cookie write has no valid CSRF token.
An RFC 9457 problem document. type is a stable TinyConductor URN.
object
The request path.
Present only on mode-not-supported. It names the engine’s mode.
Example
{ "type": "urn:bpm:error:forbidden", "title": "Forbidden", "status": 403, "detail": "The principal lacks the action this route requires", "instance": "/v2/decision-instances/2251799813685262"}The entity does not exist in the caller’s tenant.
An RFC 9457 problem document. type is a stable TinyConductor URN.
object
The request path.
Present only on mode-not-supported. It names the engine’s mode.
Example
{ "type": "urn:bpm:error:not-found", "title": "Not Found", "status": 404, "detail": "The requested resource does not exist", "instance": "/v2/decision-instances/2251799813685262"}An internal failure. The details are never exposed.
An RFC 9457 problem document. type is a stable TinyConductor URN.
object
The request path.
Present only on mode-not-supported. It names the engine’s mode.
Example
{ "type": "urn:bpm:error:internal", "title": "Internal Server Error", "status": 500, "detail": "The request could not be completed", "instance": "/v2/decision-instances/2251799813685262"}The operation is not offered in the engine’s current deployment mode.
An RFC 9457 problem document. type is a stable TinyConductor URN.
object
The request path.
Present only on mode-not-supported. It names the engine’s mode.
Example
{ "type": "urn:bpm:error:mode-not-supported", "title": "Mode Not Supported", "status": 501, "detail": "/v2/clock is not supported in bundled mode: the deterministic virtual clock and the storage-free reset exist only for the Embedded engine; Bundled and Cluster run on the system clock over durable history, which cannot be pinned, rewound or discarded", "instance": "/v2/clock", "mode": "bundled"}Backpressure, or a dependency is not ready. Retry with the same idempotency key.
An RFC 9457 problem document. type is a stable TinyConductor URN.
object
The request path.
Present only on mode-not-supported. It names the engine’s mode.
Example
{ "type": "urn:bpm:error:unavailable", "title": "Service Unavailable", "status": 503, "detail": "The required engine service is not ready", "instance": "/v2/decision-instances/2251799813685262"}