403
Forbidden
forbidden — Forbidden
Message
What causes it
- The authenticated user is not the owner of the workflow (or of the execution's or batch's workflow) the request targets. Ownership checks run after scope checks and after the record lookup.
- A template lookup was made with a token whose API client has no user (an orphaned client).
How to fix it
- Use the key belonging to the account that owns the cascade. Workflow and execution IDs are not shared across accounts.
- Confirm the id with the list endpoint for the same key (`listWorkflows`, `listExecutions`, `listBatches`) before acting on it.
Operations that return it
-
GET
/workflows/{id}Show a workflow -
GET
/workflows/{id}/test_casesList sandbox test cases for a workflow -
POST
/workflows/{id}/triggerTrigger a workflow -
GET
/workflow_templates/{id}Show a template (with definition) -
POST
/workflows/{id}/batchesCreate a batch from N rows -
POST
/batches/{id}/cancelCancel a batch -
POST
/batches/{id}/resumeResume an interrupted batch -
POST
/batches/{id}/retry_failedRetry failed and skipped rows -
GET
/batches/{id}/exports.csvDownload flat results CSV -
GET
/batches/{id}/exports.zipDownload structured ZIP of batch results -
GET
/batches/{id}/adverse_action_notices.zipDownload all adverse-action notice PDFs as a ZIP -
GET
/executions/{id}Show an execution -
POST
/executions/{id}/cancelCancel an execution -
POST
/executions/{id}/re_evaluationsRe-evaluate an execution -
POST
/executions/{id}/review_decisionsApprove or deny a paused review -
GET
/executions/{id}/review_eventsList review audit events -
POST
/executions/{id}/review_assignmentClaim or unassign a review -
POST
/executions/{id}/review_notesAppend a review note -
POST
/executions/review_bulk_actionsBulk approve / deny / assign_to_me -
GET
/executions/{id}/report_artifactsList credit-report PDFs for an execution -
GET
/executions/{id}/report_artifacts/{artifact_id}Download a credit-report PDF -
GET
/executions/{id}/notice_artifactsList adverse-action notice PDFs for an execution -
GET
/executions/{id}/notice_artifacts/{artifact_id}Download an adverse-action notice PDF
Example response
HTTP/1.1 403 Forbidden
· Content-Type: application/json
403 Forbidden
{
"error": {
"code": "forbidden",
"message": "You are not authorized to perform this action.",
"details": [],
"request_id": "6f1c2a3e-8d4b-4c5e-9f0a-1b2c3d4e5f60",
"doc_url": "https://cascades.crscreditapi.com/docs/api/errors/forbidden"
}
}