API Endpoint ReferenceDecisions
Ask the AI to revise a completed stage (does not save)
Returns a job_id — poll GET /v1/jobs/{id} for original_content and revised_content. Does NOT modify the decision: show the revision to the user, then commit it (as-is or edited) via POST /v1/decisions/{id}/refine/apply.
POST
/v1/decisions/{id}/refineAuthorizationBearer <token>
API key in dc_live_... / dc_test_... format, from /settings/api-keys.
In: header
Path Parameters
idstring
Decision or job ID.
stage_indexinteger
Zero-based index of the completed stage to refine (see get_decision for stages).
Range
0 <= value <= 9007199254740991instructionsstring
How to revise the stage, e.g. "Make it more concise" or "Add a risk analysis".
Length
1 <= length <= 5000Response Body
curl -X POST "https://api.deecee.ai/v1/decisions/string/refine" \ -H "Content-Type: application/json" \ -d '{ "stage_index": 9007199254740991, "instructions": "string" }'{
"success": true,
"data": {
"stage_index": 0,
"stage_title": "string",
"original_content": "string",
"revised_content": "string"
}
}{
"success": false,
"error": "string",
"code": "string"
}{
"success": false,
"error": "string",
"code": "string"
}{
"success": false,
"error": "string",
"code": "string"
}{
"success": false,
"error": "string",
"code": "string"
}