# Toggle SSO

Enable or disable SSO enforcement for a dashboard without changing the provider configuration.

Source: https://statusdashboard.com/docs/api/status-dashboards/dashboards/sso/toggle

`PATCH /app/dashboards/{id}/sso`

Enables or disables SSO enforcement for a dashboard. This does not modify the provider configuration — it only controls whether unauthenticated visitors are redirected to sign in. Requires the **SSO** feature entitlement.

Returns `409` if you attempt to enable SSO when no provider has been configured. Save a provider first using the [Configure SSO provider](/docs/api/status-dashboards/dashboards/sso/update) endpoint.

***

## Path parameters
| Parameter | Description                |
| --------- | -------------------------- |
| `id`      | The UUID of the dashboard. |

***

## Request
See [API Basics](/docs/api) for required headers.

### Request body
| Field     | Type    | Required | Description                                                         |
| --------- | ------- | -------- | ------------------------------------------------------------------- |
| `enabled` | boolean | Yes      | `true` to enforce SSO for visitors; `false` to disable enforcement. |

***

## Sample request
```bash
curl -X PATCH https://api.statusdashboard.com/app/dashboards/a1b2c3d4-e5f6-7890-abcd-ef1234567890/sso \
  -H "Authorization: Bearer bcf847abf5c6:def456" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'
```

## Sample response
**Status: `200 OK`**

```json
{
  "enabled": true
}
```

***

## Error responses
| Status | When                                                                 |
| ------ | -------------------------------------------------------------------- |
| `400`  | Validation error.                                                    |
| `403`  | SSO feature not enabled on the plan.                                 |
| `404`  | Dashboard not found or does not belong to the caller's organization. |
| `409`  | Cannot enable SSO: no provider is configured. Save a provider first. |