Skip to content
Updawg

`GET /v1/orgs/{org}/sso`.

GET
/v1/orgs/{org}/sso
curl --request GET \
  --url https://api.updawg.net/v1/orgs/example/sso

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

Responses

Section titled “Responses”

200

Section titled “200”

The connection (never its secret) and the claimed domains.

Media typeapplication/json
object
connection
One of:

Absent until one is saved.

object
client_id
required
string
default_role

For somebody no mapping matches; absent refuses them.

string | null
enabled
required
boolean
enforced
required
boolean
groups_claim
required
string
issuer
required
string
role_mappings
required
Array<object>
object
group
required

A value of the groups claim, exactly.

string
role
required

admin, operator or viewer.

string
updated_at
required
string format: date-time
domains
required
Array<object>
object
domain
required
string
txt_name
required

The TXT record to publish: its name…

string
txt_value
required

…and its value.

string
verified
required
boolean
verified_at
string | null format: date-time
redirect_uri
required

What to register at the provider as the sign-in redirect URI.

string
Examplegenerated
{
  "connection": {
    "client_id": "example",
    "default_role": "example",
    "enabled": true,
    "enforced": true,
    "groups_claim": "example",
    "issuer": "example",
    "role_mappings": [
      {
        "group": "example",
        "role": "example"
      }
    ],
    "updated_at": "2026-04-15T12:00:00Z"
  },
  "domains": [
    {
      "domain": "example",
      "txt_name": "example",
      "txt_value": "example",
      "verified": true,
      "verified_at": "2026-04-15T12:00:00Z"
    }
  ],
  "redirect_uri": "example"
}

401

Section titled “401”

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403”

Not permitted for this role. Or the plan does not include single sign-on (Enterprise): plan-required.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Section titled “404”

No such organization, or not yours.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

429

Section titled “429”

Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}