Create Approvals

Developing

preprod

https://preprod.api.crego.io

POST

/v1/rego/approvals/

Last modified:2025-07-08 11:03:02

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

object {0}

Example

{
  "title": "Approve Loan Document",
  "description": "Approval required for the submitted loan document.",
  "type": "document",
  "status": "pending",
  "priority": "high",
  "requested_by": "user_123",
  "requested_at": "2025-06-10T10:30:00",
  "approvers": ["approver_1", "approver_2"],
  "required_approvals": "1",
  "auto_approve_conditions": {
    "checklist_complete": true,
    "score": { "gte": 700 }
  },
  "resource_type": "loan_document",
  "resource_id": "doc_456",
  "runner": null,
  "actions": [
    {
      "user_id": "user_123",
      "action": "pending",
      "timestamp": "2025-06-10T10:30:00",
      "comments": "Initial request",
      "metadata": {}
    }
  ],
  "approved_by": [],
  "rejected_by": [],
  "completed_at": null,
  "expires_at": "2025-06-20T23:59:59",
  "metadata": {
    "loan_id": "loan_789",
    "program": "Prime Lending"
  },
  "attachments": ["file_001", "file_002"],
  "company_id": "company_001"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://preprod.api.crego.io/v1/rego/approvals/' \
--header 'Content-Type: application/json' \
--data-raw '{
  "title": "Approve Loan Document",
  "description": "Approval required for the submitted loan document.",
  "type": "document",
  "status": "pending",
  "priority": "high",
  "requested_by": "user_123",
  "requested_at": "2025-06-10T10:30:00",
  "approvers": ["approver_1", "approver_2"],
  "required_approvals": "1",
  "auto_approve_conditions": {
    "checklist_complete": true,
    "score": { "gte": 700 }
  },
  "resource_type": "loan_document",
  "resource_id": "doc_456",
  "runner": null,
  "actions": [
    {
      "user_id": "user_123",
      "action": "pending",
      "timestamp": "2025-06-10T10:30:00",
      "comments": "Initial request",
      "metadata": {}
    }
  ],
  "approved_by": [],
  "rejected_by": [],
  "completed_at": null,
  "expires_at": "2025-06-20T23:59:59",
  "metadata": {
    "loan_id": "loan_789",
    "program": "Prime Lending"
  },
  "attachments": ["file_001", "file_002"],
  "company_id": "company_001"
}'

Responses

🟢201Created

application/json

Body

string

required

title

string

required

description

string

required

type

string

required

status

string

required

priority

string

required

requested_by

string

required

requested_at

string

required

completed_at

null

required

expires_at

string

required

approvers

array[string]

required

required_approvals

string

required

resource_type

string

required

resource_id

string

required

runner_id

null

required

actions

array [object {5}]

required

user_id

string

optional

action

string

optional

timestamp

string

optional

comments

string

optional

metadata

object

optional

approved_by

array

required

rejected_by

array

required

progress

object

required

current_approvals

integer

required

required_approvals

integer

required

remaining

integer

required

approved_by

array

required

rejected_by

array

required

can_proceed

boolean

required

metadata

object

required

loan_id

string

required

program

string

required

attachments

array[string]

required

created_at

string

required

updated_at

null

required

created_by

null

required

Example

{
    "id": "string",
    "title": "string",
    "description": "string",
    "type": "string",
    "status": "string",
    "priority": "string",
    "requested_by": "string",
    "requested_at": "string",
    "completed_at": null,
    "expires_at": "string",
    "approvers": [
        "string"
    ],
    "required_approvals": "string",
    "resource_type": "string",
    "resource_id": "string",
    "runner_id": null,
    "actions": [
        {
            "user_id": "string",
            "action": "string",
            "timestamp": "string",
            "comments": "string",
            "metadata": {}
        }
    ],
    "approved_by": [
        null
    ],
    "rejected_by": [
        null
    ],
    "progress": {
        "current_approvals": 0,
        "required_approvals": 0,
        "remaining": 0,
        "approved_by": [
            null
        ],
        "rejected_by": [
            null
        ],
        "can_proceed": true
    },
    "metadata": {
        "loan_id": "string",
        "program": "string"
    },
    "attachments": [
        "string"
    ],
    "created_at": "string",
    "updated_at": null,
    "created_by": null
}

Modified at 2025-07-08 11:03:02

Pending Approval

Get Approval