Skip to navigation

Native Approval Policies

View as Markdown

tool.access-software.workflows

Native approval policies — named decision trees (manager, specific-user, quorum steps). name is immutable and is the reference other configs use (e.g. a software app’s approval_key.custom_key, group access ADD_TO_DL_APPROVAL).

  • Endpoint: /tool/access-software/workflows | Methods: GET, PATCH, POST
  • Request shape: fields go at the top level of the JSON body, with no resource wrapper. The item’s id goes in the URL for reads and updates, not in the body.
  • Updates: a JSON merge-patch. Send only the fields you change, plus version: {num, change_description} with the num from your last read. Lists and maps you send replace the stored ones whole.

Endpoints

All paths are relative to https://api.moveworks.ai/configurations/v1alpha1. Each endpoint page lists the request and response schema, an example, and the errors it can return.

MethodPathEndpoint reference
GET/tool/access-software/workflowsList native approval policies
POST/tool/access-software/workflowsCreate native approval policy
GET/tool/access-software/workflows/{id}Get native approval policy
PATCH/tool/access-software/workflows/{id}Update native approval policy

Fields

FieldTypeRequiredNotes
idstringread-onlyUnique identifier of the workflow, assigned by the server.
namestring✅Name of the workflow, used by other configurations to reference it. Must be unique in the org and cannot be changed after creation. Letters, numbers, underscores, and hyphens only.
expressionApprovalExp✅The approval decision tree for this workflow.
updated_timestringread-onlyWhen the configuration was last updated.
updated_bystringread-onlyWho last updated the configuration.
versionVersion✅Document version. On update, send back the num from your last read.

Example create body

{
"name": "example-name",
"expression": {
"user_constant_expression": {
"user": "<string>"
}
},
"version": {
"change_description": "Create native approval policy"
}
}