> This page is for API Reference & Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Native Approval Policies

> Create, read and update Native Approval Policies through the Moveworks Configuration API: endpoints, fields and examples.

`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.

| Method  | Path                                   | Endpoint reference                                                                                                                 |
| ------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `GET`   | `/tool/access-software/workflows`      | [List native approval policies](/api-reference/configuration-api/approvals/native-approval-policies/list-native-approval-policies) |
| `POST`  | `/tool/access-software/workflows`      | [Create native approval policy](/api-reference/configuration-api/approvals/native-approval-policies/create-native-approval-policy) |
| `GET`   | `/tool/access-software/workflows/{id}` | [Get native approval policy](/api-reference/configuration-api/approvals/native-approval-policies/get-native-approval-policy)       |
| `PATCH` | `/tool/access-software/workflows/{id}` | [Update native approval policy](/api-reference/configuration-api/approvals/native-approval-policies/update-native-approval-policy) |

### Fields

| Field          | Type        | Required  | Notes                                                                                                                                                                                |
| -------------- | ----------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`           | string      | read-only | Unique identifier of the workflow, assigned by the server.                                                                                                                           |
| `name`         | string      | ✅         | 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. |
| `expression`   | ApprovalExp | ✅         | The approval decision tree for this workflow.                                                                                                                                        |
| `updated_time` | string      | read-only | When the configuration was last updated.                                                                                                                                             |
| `updated_by`   | string      | read-only | Who last updated the configuration.                                                                                                                                                  |
| `version`      | Version     | ✅         | Document version. On update, send back the num from your last read.                                                                                                                  |

### Example create body

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