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

# Account Access

> Read and update Account Access through the Moveworks Configuration API: endpoints, fields and examples.

`tool.access-account`

Forgot-password settings and connector bidding are NOT exposed by this API.

* **Endpoint:** `/tool/access-account`  |  **Methods:** GET, PATCH
* **Request shape:** one per organization, so there is no `id`. It already exists: read it with `GET`, then `PATCH` the fields you want to change. Fields go at the top level of the JSON body, with no `resource` wrapper.
* **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-account` | [Get account access](/api-reference/configuration-api/access-skills/account-access/get-account-access)       |
| `PATCH` | `/tool/access-account` | [Update account access](/api-reference/configuration-api/access-skills/account-access/update-account-access) |

### Fields

| Field                       | Type                  | Required  | Notes                                                                                                                                                                                     |
| --------------------------- | --------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account_unlock_options`    | AccountUnlockOptions  |           | Settings for the account unlock skill.                                                                                                                                                    |
| `mfa_reset_options`         | MFAResetOptions       |           | Settings for the MFA reset skill.                                                                                                                                                         |
| `change_password_options`   | ChangePasswordOptions |           | Settings for proactive password expiry notifications.                                                                                                                                     |
| `password_lifespan_seconds` | any                   |           | How long, in seconds, a password lasts before it expires and must be changed. Used to compute expiry dates for proactive notifications. Minimum 86400 (1 day); omit for no expiry policy. |
| `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.                                                                                                                       |

### Document fields (example)

The document as `GET` returns it. To change any of these, send only the fields you want to change in the `PATCH` body.

```json
{
  "account_unlock_options": {
    "proactive_reachout_filter_dsl": "true",
    "proactive_reachout_query_enabled_dsl": "true"
  },
  "mfa_reset_options": {
    "reset_mode": "MFA_RESET_MODE_UNSPECIFIED"
  },
  "change_password_options": {
    "change_passwords_reminder_enabled": true,
    "proactive_reachout_filter_dsl": "true",
    "start_notifications_before_seconds": 0
  },
  "password_lifespan_seconds": 0
}
```