---
title: "Single sign-on and directory sync: each identity provider, its domain and whether it is proven, the role people join with, whether SSO is required, and SCIM groups."
method: GET
path: "/v1/sso"
tags: ["sso"]
---

# Single sign-on and directory sync: each identity provider, its domain and whether it is proven, the role people join with, whether SSO is required, and SCIM groups.

`GET /v1/sso`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/sso`
- Auth: HTTP bearer

Read only; an owner changes single sign-on at withruntime.com/account/single-sign-on. Needs a key for every product or a read-only key, made by an owner or admin.

## Response `200`

Success

- object
  - `connections` object[], required
    - `id` string, required
    - `providerId` string, required: Names the connection in its sign-in URLs.
    - `protocol` 'oidc' | 'saml', required
    - `provider` 'okta' | 'entra' | 'google' | 'other', required
    - `domain` string, required: The email domain it answers for.
    - `domainVerifiedAt` string, nullable, required: When the domain was proven by DNS; null until then, and until then nobody signs in through it.
    - `verification` object, required: The DNS record that proves the domain.
      - `type` 'TXT', required
      - `name` string, required
      - `value` string, required
    - `defaultRole` 'admin' | 'developer' | 'billing', required
    - `requireSso` boolean, required: Members other than owners may sign in only through it. API keys are unaffected.
    - `createdAt` string, required
  - `scim` object, required
    - `tokens` integer, required: Live SCIM tokens.
    - `users` integer, required: People the directory has pushed.
    - `activeUsers` integer, required
    - `groups` object[], required
      - `id` string, required
      - `displayName` string, required
      - `role` string, nullable, required: The role the group gives, or null.
  - `manage` string, required: Where an owner changes single sign-on.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)