Mandatory Due Date Settings

Configure whether due dates are required when creating or editing access reviews.

Configure whether due dates are required when creating or editing access reviews. When enabled, review creators must specify a due date before creating a review.

This setting can be configured globally or per-workflow. When a workflow-specific setting is applied, it overrides the global setting for reviews created from that Review Configuration.

Parameters

The setting accepts an object with boolean fields for each review level:

Field	Type	Description
mandatory_for_first_level	boolean	Require due date for first-level (primary) reviews
mandatory_for_second_level	boolean	Require due date for second-level reviews
mandatory_for_third_level	boolean	Require due date for third-level reviews

Examples

Enable mandatory due dates for first-level reviews only:

{
    "value": {
        "mandatory_for_first_level": true,
        "mandatory_for_second_level": false,
        "mandatory_for_third_level": false
    }
}

Enable mandatory due dates for all review levels:

{
    "value": {
        "mandatory_for_first_level": true,
        "mandatory_for_second_level": true,
        "mandatory_for_third_level": true
    }
}

Example cURL request (global setting):

curl -L -X PUT 'https://your-organization.vezacloud.com/api/private/workflows/access/global_settings/mandatory_due_date_for_review_settings' \
  -H 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": {
        "mandatory_for_first_level": true,
        "mandatory_for_second_level": false,
        "mandatory_for_third_level": false
    }
  }'

Example cURL request (workflow-specific setting):

curl -L -X PUT 'https://your-organization.vezacloud.com/api/private/workflows/access/global_settings/mandatory_due_date_for_review_settings' \
  -H 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "workflow_id": "8ae1c414-3a76-46cb-950a-925316b3f264",
    "value": {
        "mandatory_for_first_level": true,
        "mandatory_for_second_level": true,
        "mandatory_for_third_level": false
    }
  }'

Get Mandatory Due Date Settings

Get Mandatory Due Date Settings

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

workflow_idstringOptional

Optional workflow ID to get workflow-specific settings

Example: 8ae1c414-3a76-46cb-950a-925316b3f264

Header parameters

AcceptstringOptionalExample: application/json

Responses

200

OK

application/json

get

/api/private/workflows/access/global_settings/mandatory_due_date_for_review_settings

HTTPcURLJavaScriptPython

GET /api/private/workflows/access/global_settings/mandatory_due_date_for_review_settings HTTP/1.1
Host: {{baseurl}}
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "value": {
    "mandatory_for_first_level": false,
    "mandatory_for_second_level": false,
    "mandatory_for_third_level": false
  }
}

Set Mandatory Due Date Settings

Set Mandatory Due Date Settings

put

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

Content-TypestringOptionalExample: application/json

AcceptstringOptionalExample: application/json

Body

application/json

workflow_idstringOptional

Optional workflow ID for workflow-specific settings

Responses

200

OK

application/json

objectOptional

put

/api/private/workflows/access/global_settings/mandatory_due_date_for_review_settings

HTTPcURLJavaScriptPython

PUT /api/private/workflows/access/global_settings/mandatory_due_date_for_review_settings HTTP/1.1
Host: {{baseurl}}
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 166

{
  "workflow_id": "8ae1c414-3a76-46cb-950a-925316b3f264",
  "value": {
    "mandatory_for_first_level": true,
    "mandatory_for_second_level": false,
    "mandatory_for_third_level": false
  }
}

200

OK

{}