ResyncSSOPlatform
Trigger a SCIM resynchronization for one associated platform.
/api/v1/sso/configurations/{id}/platforms/{platformUuid}/resyncOperation ID
ResyncSSOPlatformSince
1.0.0Execution Mode
SynchronousAuth Context
Auth RequiredAuth Context
Send these values as request headers when calling this API.
AuthorizationstringRequiredBearer Token
X-Tenant-IDstringX-Tenant-ID
Request Inputs
Path Parameters
idStringRequiredSSO configuration UUID.
platformUuidStringRequiredTarget platform UUID.
Responses
200 OKOn success, this API returns the following response structure.
uuidStringUnique identifier of this federation record.
Example: fed-001
ssoConfigUuidStringUUID of the SSO configuration that was federated.
Example: sso-cfg-001
platformUuidStringUUID of the target platform to which the SSO config was pushed.
Example: platform-abc123
productTypeStringProduct type of the target platform receiving the federation.
Example: zstack
ssoClientUuidStringClient UUID assigned by the target platform after successful federation.
Example: client-xyz
callbackUrlStringCallback URL registered on the target platform for this federation.
Example: https://platform.example.com/sso/callback
metadataStringAdditional metadata associated with this federation record.
Example: {}
statusStringCurrent status of the federation operation.
Example: success
errorMessageStringError message if the federation operation failed.
Example: authentication failed
federatedAtStringFederated at
Example: 2026-01-15T08:00:00Z
updatedAtStringUpdated at
Example: 2026-01-15T08:00:00Z
ssoConfigNameStringDisplay name of the SSO configuration that was federated to this platform.
Example: Corporate SSO
configStatusStringConfiguration dispatch status for this platform association.
Example: value
readyStatusStringWhether the downstream SCIM endpoint is ready for synchronization.
Example: value
syncStatusStringCurrent SCIM synchronization status for this platform association.
Example: value
lastSyncAtStringLast successful SCIM sync time for this platform association.
Example: 2026-01-15T08:00:00Z
scimBaseUrlStringDownstream SCIM endpoint base URL configured for this association.
Example: https://example.com/callback
scimTokenConfiguredBooleanWhether this federation has a stored SCIM bearer token.
Example: true
scimSyncScopeListSCIM resource types enabled for this association.
Example: item1,item2
scimResourceConfigsListResource-specific field and role mappings for this association.
Example: (nested array)
resourceStringSCIM resource type, e.g. Users, Groups, Roles, or RoleBindings.
Example: value
fieldMappingsListField mappings applied before dispatching events to this target.
Example: (nested array)
sourceStringSource field name in the ZIAM SCIM event payload.
Example: value
targetStringTarget field name expected by the downstream platform.
Example: value
requiredBooleanWhether this mapped field must be present after defaulting.
Example: true
defaultValueStringDefault value used when the source field is empty.
Example: value
roleMappingsListRole mappings applied to RoleBindings events before dispatching.
Example: (nested array)
roleKeyStringStable role key from ZIAM/Casdoor.
Example: value
downstreamRoleUuidStringRole UUID expected by the downstream platform.
Example: value
targetAccountUuidStringOptional downstream account UUID used for role binding creation.
Example: value
scimLastTestAtStringLast time the SCIM endpoint was tested.
Example: 2026-01-15T08:00:00Z
scimLastTestResultStringResult of the most recent SCIM endpoint test.
Example: value
scimLastTestErrorStringError from the most recent SCIM endpoint test.
Example: value
