StartApprovalRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-drive/json-schema/google-drive-start-approval-request-schema.json",
  "title": "StartApprovalRequest",
  "description": "Allows creating an approval on a file.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-drive-approvals-api-openapi.yml#/components/schemas/StartApprovalRequest",
  "type": "object",
  "properties": {
    "lockFile": {
      "type": "boolean",
      "description": "Optional. Whether to lock the file when starting the approval."
    },
    "dueTime": {
      "type": "string",
      "description": "Optional. The time that the approval is due.",
      "format": "google-datetime"
    },
    "reviewerEmails": {
      "type": "array",
      "description": "Required. The emails of the users who are set to review the approval.",
      "items": {
        "type": "string"
      }
    },
    "fileContentChangeBehavior": {
      "type": "string",
      "description": "Optional. The behavior of the approval when the file content changes.",
      "enum": [
        "FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED",
        "RESET_APPROVAL",
        "NO_APPROVAL_ACTION"
      ]
    },
    "message": {
      "type": "string",
      "description": "Optional. A message to send to reviewers when notifying them of the approval request."
    }
  }
}