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

# Identity Ingestion (Integration)

> Read and update Identity Ingestion (Integration) through the Moveworks Configuration API: endpoints, fields and examples.

`platform.identity.integration`

Identity ingestion: the sources (connectors) the Moveworks user profile is built from — primary source, per-source joining key/universal id, attribute-mapping benders, filters, and merge overrides.

* **Endpoint:** `/platform/identity/integration`  |  **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`   | `/platform/identity/integration` | [Get identity ingestion](/api-reference/configuration-api/platform-org/identity-ingestion-integration/get-identity-ingestion)       |
| `PATCH` | `/platform/identity/integration` | [Update identity ingestion](/api-reference/configuration-api/platform-org/identity-ingestion-integration/update-identity-ingestion) |

### Fields

| Field                            | Type           | Required  | Notes                                                                                                                                                                    |
| -------------------------------- | -------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sources`                        | array\<Source> |           | Identity sources used to build the Moveworks user profile. On update, include every source to keep; omitted sources are removed. 1 to 99 sources.                        |
| `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.                                                                                                      |
| `override_user_profile_mappings` | object         |           | Mappings applied after all sources are merged, overriding user profile fields with values from other sources. On update, send the full map; omitted entries are removed. |

### 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
{
  "sources": [
    {
      "connector_id": "<connector-uuid>",
      "primary": true,
      "processors": [
        {
          "item_ref": "<string>",
          "user_timezone_processor": {
            "...": "see UserTimezoneProcessor"
          }
        }
      ],
      "filters": [
        {
          "item_ref": "<string>",
          "generic_filter": {}
        }
      ],
      "item_ref": "<string>",
      "joining_key": "<string>",
      "user_profile_mappings": {}
    }
  ],
  "override_user_profile_mappings": {}
}
```