Endpoint target address is as found in the decision management portal.
| HTTP Method | Request Content-Type | Response Content-Type | Charset |
|---|---|---|---|
| POST | application/json | application/json | UTF-8 |
Request headers
| Header | Value |
|---|---|
| X-API-KEY: | __YOUR_ENDPOINT_API_KEY__ |
| Content-Type: | application/json |
Optional GET parameters
| Parameter | Type | Description |
|---|---|---|
| record_lineage | integer | Records the lineage of data transformations during execution. Level 0 (or false): No lineage recordingLevel 1 (or true): Basic lineage with step name, state, and deltaLevel 2: Enhanced lineage including step types Useful for audit trails and debugging. |
| record_steps | integer | Records execution steps for the decision process. Level 0 (or false): No step recordingLevel 1 (or true): Basic step recordingLevel 2: Detailed tracing with granular visibility into decision logic flow |
Examples:
POST https://your-endpoint.decisimo.com/endpoint_name?record_lineage=1&record_steps=1
POST https://your-endpoint.decisimo.com/endpoint_name?record_lineage=2&record_steps=2
POST https://your-endpoint.decisimo.com/endpoint_name?record_lineage=true&record_steps=true
HTTP Response codes
| Response Code | |
|---|---|
| 200 OK | Processed successfully |
| 400 Bad request | Malformed JSON |
| 401 Unauthorized | Missing API Key |
| 404 Not found | The endpoint was not found on the platform. |
| 429 Too Many Requests | Rate limit reached. The body is {"error": "rate_limited"}. See Rate Limits below. |
| 500 Internal Server Error | Some problem on Decisimo side. |
Execution Time Limit
Each request has a max execution time of 300s. Longer executions are terminated.
This is especially relevant when calling LLM services, long-running models, or using external data for enrichment.
Rate Limits
On shared endpoints, each endpoint accepts up to 50 requests per second and runs up to 10 requests at the same time, unless your contract sets different limits. A request over either limit gets 429 Too Many Requests with a Retry-After: 1 header and the error code rate_limited. A refused request does not run the decision flow and is not billed. Wait the number of seconds in Retry-After, then send it again.
Recommended integration
- Generate payload - Data object
- Store prepared payload in database
- Call decision engine
- Store response payload in the database
- Continue in business process according to the decision
Payload limitations
Decisimo has two limitations on the payload
- must be valid JSON object;
- cannot be larger than 1MB.