Authentication

→

https://api.spectrocloud.com/v1/auth/authenticate

summary:

Authenticates the user for the specified crendentials

description:

Authenticates the user

Parameters:

Name	Type	Description	Required
setCookie	boolean		no

Body

{
  "emailId": "string",
  "org": "string",
  "password": "string"
}

HTTP code: 200
Description: OK
Response body:

{
  "Authorization": "string"
}

deprecated→

https://api.spectrocloud.com/v1/auth/login

summary:

Deprecated. Returns the authentication type for the specified user email id

description:

Deprecated. Returns the authentication type for the specified user email id

Body

{
  "emailId": "string"
}

HTTP code: 200
Description: OK
Response body:

{
  "appEnv": "string",
  "authType":deprecated "string",
  "orgName":deprecated "string",
  "orgs": [
    {
      "authType": "string",
      "orgName": "string",
      "redirectUrl": "string"
    }
  ],
  "redirectUrl":deprecated "string"
}

→

https://api.spectrocloud.com/v1/auth/org

summary:

Returns the user organization details

Parameters:

Name	Type	Description	Required
orgName	string		no

HTTP code: 200
Description: OK
Response body:

{
  "appEnv": "string",
  "authType": "string",
  "orgName": "string",
  "redirectUrl": "string",
  "rootDomain": "string",
  "ssoLogins": {
    "items": {
      "displayName": "string",
      "logo": "string",
      "name": "string",
      "redirectUri": "string"
    }
  },
  "totalTenants": "number"
}

→

https://api.spectrocloud.com/v1/auth/org/{orgName}/switch

summary:

switches organisation for the user if user belongs to particular org

description:

switches organisation for the user if user belongs to particular org

Parameters:

Name	Type	Description	Required
setCookie	boolean		no
orgName	string		yes

HTTP code: 200
Description: OK
Response body:

{
  "Authorization": "string"
}

→

https://api.spectrocloud.com/v1/auth/org/{org}/oidc/callback

summary:

Idp authorization code callback

Path parameters:

Name	Type	Required
org	string	yes
code	string	no
state	string	no
error	string	no
error_description	string	no

HTTP code: 200
Description: OK
Response body:

{
  "Authorization": "string"
}

→

https://api.spectrocloud.com/v1/auth/org/{org}/oidc/logout

summary:

Identity provider logout url for the Oidc

Path parameters:

Name	Type	Description	Required
org	string		yes
state	string		no

HTTP code: 204
Description: Ok reponse without content

→

https://api.spectrocloud.com/v1/auth/org/{org}/saml/callback

summary:

Identity provider callback url for the SMAL authentication

Parameters:

Name	Type	Description	Required
SAMLResponse	string		no

Path parameters:

Name	Type	Description	Required
org	string		yes
authToken	string		no

HTTP code: 200
Description: OK
Response body:

{
  "Authorization": "string"
}

→

https://api.spectrocloud.com/v1/auth/org/{org}/saml/logout

summary:

Identity provider logout url for the SMAL

Parameters:

Name	Type	Description	Required
SAMLResponse	string		no

Path parameters:

Name	Type	Description	Required
org	string		yes
authToken	string		no

HTTP code: 204
Description: Ok reponse without content

→

https://api.spectrocloud.com/v1/auth/orgs

summary:

Returns the list of user associated organizations based on the authorization token.

HTTP code: 200
Description: OK
Response body:

{
  "organizations": [
    {
      "name": "string",
      "redirectUrl": "string",
      "ssoLogins": {
        "items": {
          "displayName": "string",
          "logo": "string",
          "name": "string",
          "redirectUri": "string"
        }
      }
    }
  ]
}

→

https://api.spectrocloud.com/v1/auth/password/{passwordToken}/activate

summary:

Activates the specified user password using the password token

Path parameters:

Name	Type	Description	Required
passwordToken	string		yes

Body

{
  "password": "string"
}

HTTP code: 204
Description: The resource was updated successfully

→

https://api.spectrocloud.com/v1/auth/password/{passwordToken}/reset

summary:

Resets the user password using the password token

Path parameters:

Name	Type	Description	Required
passwordToken	string		yes

Body

{
  "password": "string"
}

HTTP code: 204
Description: The resource was updated successfully

→

https://api.spectrocloud.com/v1/auth/refresh/{token}

summary:

Refreshes authentication token

description:

Issues a new token within refresh timeout and same session id is maintained

Path parameters:

Name	Type	Description	Required
setCookie	boolean		no
token	string		yes

HTTP code: 200
Description: OK
Response body:

{
  "Authorization": "string"
}

→

https://api.spectrocloud.com/v1/auth/sso/idps

summary:

Returns the list of supported identity providers

HTTP code: 200
Description: (empty)
Response body:

{
  "items": {
    "id": "string",
    "name": "string"
  }
}

→

https://api.spectrocloud.com/v1/auth/sso/logins

summary:

Returns the list of supported sso logins

Parameters:

Name	Type	Description	Required
org	string		no

HTTP code: 200
Description: (empty)
Response body:

{
  "items": {
    "displayName": "string",
    "logo": "string",
    "name": "string",
    "redirectUri": "string"
  }
}

→

https://api.spectrocloud.com/v1/auth/sso/providers

summary:

Returns the list of supported sso auth providers

HTTP code: 200
Description: (empty)
Response body:

{
  "items": {
    "displayName": "string",
    "logo": "string",
    "name": "string",
    "redirectUri": "string"
  }
}

→

https://api.spectrocloud.com/v1/auth/sso/{ssoApp}/callback

summary:

sso authorization code callback

Path parameters:

Name	Type	Required
ssoApp	string	yes
code	string	no
state	string	no
error	string	no
error_description	string	no

HTTP code: 200
Description: OK
Response body:

{
  "Authorization": "string"
}

→

https://api.spectrocloud.com/v1/auth/user/org/forgot

summary:

Send the user organization information via email.

Parameters:

Name	Type	Description	Required
emailId	string		yes

HTTP code: 204
Description: Ok reponse without content

→

https://api.spectrocloud.com/v1/auth/user/password/reset

summary:

Resets the user password via email. Password reset email will be sent to the user

Body

{
  "emailId": "string"
}

HTTP code: 204
Description: Ok reponse without content

Edit on GitHub