---
title: "Get role IdP Sync settings by organization"
method: GET
path: "/api/v2/organizations/{organization}/settings/idpsync/roles"
tags: ["Enterprise"]
---

# Get role IdP Sync settings by organization

`GET /api/v2/organizations/{organization}/settings/idpsync/roles`

## Path parameters

- `organization` string, uuid, required

## Response `200`

OK

- CodersdkRoleSyncSettings
  - `field` string — Field is the name of the claim field that specifies what organization roles a user should be given. If empty, no roles will be synced.
  - `mapping` object — Mapping is a map from OIDC groups to Coder organization roles.

---

[API](https://skmtc.dev/coder/apis/coder-api.md) · [All operations](https://skmtc.dev/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coder/coder-api/revisions/369ae60ab00e/schema)
