Create User:
POST https://www.knowi.com/sso/user/create
| Parameter | Type | Description |
| ssoCustomerToken | string | Required. Customer-specific SSO Token to authorize SSO user management. |
| user | string | Required. Email/username of the new or existing user. |
| userGroups[] | array of strings | An array of groups the user will be associated with. Note: Group will be created if it does not exist. Send an empty array ([]) to remove dissociate the user from all groups. |
| contentFilter | object | A JSON object to apply a row-level filter on data user is allowed to see. Ex: [{"fieldName": "region", "values":["Canada","Mexico"], "operator":"="}] |
| role | string | Role and permissions to assign the user. Defaults to system user if blank. |
| refresh | bool | If True, the user's properties (i.e. userGroups[], contentFilter, role) will be updated with new values. |
| refreshToken | bool | If set to false, the user token will not be refreshed. If the flag is false and the user does not exist, a new user will still be created with a new token. Defaults to true. |
Returns:
A user-specific token. Store this for your user within your system.Example:
curl -i -X POST -d "userGroups[]=First Group&userGroups[]=Second Group&user=a@a.com&ssoCustomerToken=9ebdlklfWlYuQXPXanqHxq7ZflklfZ1pGC8Ny8l2is9uNhMie" https://www.knowi.com/sso/user/createCreate Session:
POST https://www.knowi.com/sso/session/create
| Parameter | Type | Description |
| user | string | Required. Email/username of the existing user. |
| userToken | string | Required. Token returned from user creation (/sso/user/create) |
| expiry | integer | Optional. Number of minutes from the token creation datetime until expiration. By default, session tokens expire after 30 minutes. |
Returns:
A session Id/token with an expiry of 1440 minutes from the creation datetime.Example:
curl -i -X POST -d "user=a@a.com&userToken=NUAslkrtRTTFMvscpiislikfyfhsgu491is7plqRvwvJGEgm7JVU8ie&expiry=1440" https://www.knowi.com/sso/session/createDelete User:
POST: https://www.knowi.com/sso/user/remove
| Parameter | Type | Description |
| user | string | Required. Email/username of the existing user. |
| userToken | string | Required. Token returned from user creation (/sso/user/create) |
| ssoCustomerToken | string | Required. Customer-specific SSO Token to authorize SSO user management. |
Update User Filter:
POST: https://www.knowi.com/sso/user/contentfilters/update
| Parameter | Type | Description |
| contentFilter | string | Required. A JSON object to apply a row-level filter on data user is allowed to see. Ex: [{"fieldName": "region", "values":["Italy"], "operator":"="}] |
| user | string | Required. Email/username of the existing user. |
| ssoCustomerToken | string | Required. Customer-specific SSO Token to authorize SSO user management. |
Example:
curl -i -X POST -d "user=demoSSO@knowi.com&ssoCustomerToken=9ebdlklfWlYuQXPXanqHxq7ZflklfZ1pGC8Ny8l2is9uNhMie&contentFilter=[{\"fieldName\":\"customer\",\"values\":[\"Costco\"],\"operator\":\"=\"}]" https://www.knowi.com/sso/user/contentfilters/update