---
title: "Workspace SSO configuration"
method: GET
path: "/workspaces/{workspace_id}/sso"
tags: ["authentication"]
---

# Workspace SSO configuration

`GET /workspaces/{workspace_id}/sso`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/sso`
- Auth: none declared
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/sso/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the SSO configuration for a workspace.

## Path parameters

- `workspace_id` integer, required

## Response `200`

Successful operation.

- SsoConfigResult
  - `config` ModelsSSOConfig
    - `certificate` string
    - `domain` string
    - `enabled` boolean
    - `entity_id` string
    - `metadata_url` string
    - `name` string
    - `sso_url` string
  - `sp_settings` SsoSPSettings
    - `acs_url` string
    - `entity_id` string

## Other responses

- `403`: Possible message error: Could be one of these: Workspace not found/accessible, Need to be the owner of the organization, Only valid for premium workspace and "Single Sign On must be enabled
- `500`: We're sorry, but something went terribly wrong. We have been notified about the error. Please try again later.

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)
