List identity provider connections

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$
Responses
200

OK

application/json
countnumberOptional

Total count of objects in the list

get/orgs/{organizationId}/idp-connections
GET /v1/orgs/{organizationId}/idp-connections HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "next": {
    "page": "text"
  },
  "count": 1,
  "items": [
    {
      "object": "idp-connection",
      "id": "text",
      "label": "text",
      "provider": "okta",
      "status": "pending",
      "defaultRole": "admin",
      "defaultTeam": {
        "object": "team",
        "id": "text",
        "title": "text",
        "members": 1,
        "spaces": 1,
        "createdAt": "2026-01-01T00:00:00.000Z",
        "permissions": {
          "admin": true,
          "view": true
        }
      },
      "defaultTeamFromDomain": true,
      "saml": {
        "ssoURL": "https://example.com",
        "entityID": "text",
        "certificate": "text",
        "domains": [
          {
            "domain": "text",
            "status": "verified"
          }
        ],
        "service": {
          "acsURL": "https://example.com",
          "startURL": "https://example.com",
          "entityID": "text"
        },
        "lastUsedAt": "2026-01-01T00:00:00.000Z"
      },
      "scim": {
        "baseURL": "https://example.com",
        "tokenHint": "text",
        "tokenCreatedAt": "2026-01-01T00:00:00.000Z",
        "lastUsedAt": "2026-01-01T00:00:00.000Z"
      },
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "urls": {
        "location": "https://example.com"
      }
    }
  ]
}

Last updated

Was this helpful?

Powered by GitBook