Sign in
scim

Read one SCIM binding and its attention states.

Changed on

Deliberately keeps working while the referenced provider is disabled or removed: the whole wire surface fails closed in that state, and "state is preserved for repair" is not preserved by a surface that refuses to show the state.

get/api/v1/orgs/{org}/scim-bindings/{binding}

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/orgs/{org}/scim-bindings/{binding}
  • Auth: HTTP bearer

Response

The binding.

idstring required

A prefixed UUIDv7, e.g. org_0198….

org_idstring required

A prefixed UUIDv7, e.g. org_0198….

provider_kind'oidc' | 'saml' required
provider_slugstring required
provider_issuerstring required

Frozen at creation. A provider whose issuer moved under a binding is a rebinding hazard, not a rename to follow silently.

subject_sourcestring required

The SCIM attribute path carrying identity material, immutable after creation. userName is refused by name.

nameid_formatstring

The SAML NameID profile's Format URI; empty for an OIDC binding.

nameid_qualifierstring

The SAML NameID profile's fixed NameQualifier.

nameid_qualifier_presentboolean

Whether the assertion carries a NameQualifier at all. Presence is reported separately from value because an absent qualifier and an empty one are different inputs to the injective subject encoder.

nameid_sp_qualifierstring

The SAML NameID profile's fixed SPNameQualifier.

nameid_sp_qualifier_presentboolean
connection_principal_idstring required

A prefixed UUIDv7, e.g. org_0198….

last_contact_atstring date-time

RFC 3339 UTC, microsecond precision.

created_atstring date-time required

RFC 3339 UTC, microsecond precision.

Changes

  • 54b2780eec85Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • f84a1cd8a05aRevision changes
    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status