Home
DocumentationTutorialsTry Cloud

Auth

Our API uses JSON Web Tokens (JWTs) for authentication. JWTs are a secure and efficient way to authenticate users.

To authenticate with our API, users must first create an account. Once they have created an account, they can generate a JWT by providing their username and password.

JWTs are signed with a secret key, which ensures that they are tamper-proof. They also contain an expiration date, which helps to prevent them from being used after they have expired.

To authenticate with our API, users must include their JWT in the Authorization header of their HTTP requests. The format of the Authorization header is as follows:

Authorization: Bearer <jwt>

where <jwt> is the JWT token.

Once the API has verified the JWT, it will grant the user access to the resources that they are authorized to access.

Login

POST {{BASE_URL}}/api/login

User authentication via email and password fields.

Request Body

Name
Type
Description

email*

String

password*

String

{
    "userToken": "userToken",
    "vaultToken": "teamToken"
}

Create User

POST {{BASE_URL}}/api/register

User Registration. After registration you will need to confirm your email.

Request Body

Name
Type
Description

email*

String

password*

String

name*

String

{
    "userToken": "userToken",
    "vaultToken": "teamToken"
}

After registration, a confirmation email will be sent to the user.

Verify email

GET {{BASE_URL}}/api/verify-email/{token}

User confirmation via email.

Path Parameters

Name
Type
Description

token*

String

Bearer Token

{
    "userToken": "userToken",
    "vaultToken": "teamToken"
}

After verification, a default team and a default project will be created for the client.

If the letter has not arrived in the post, you can use the endpoint below to resend it.

Resend email verification

GET {{BASE_URL}}/api/resend-email-verification

Request to resend the user's confirmation email to the user's email.

Query Parameters

Name
Type
Description

capcha*

String

Headers

Name
Type
Description

Authorization*

String

Bearer Token

{
    "userToken": "userToken",
    "vaultToken": "teamToken"
}

Refresh token

GET {{BASE_URL}}/api/refresh

Update jwt tokens.

Headers

Name
Type
Description

Authorization*

String

Bearer Token

{
    "userToken": "userToken",
    "vaultToken": "teamToken"
}

If a customer forgets their password, they can use the endpoint below. An email will then be sent to the user to recover the password.

Forgot password

POST {{BASE_URL}}/api/forgot-passsword

Password recovery via email.

Headers

Name
Type
Description

Authorization*

String

Bearer Token

Request Body

Name
Type
Description

email*

String

{
    "status": "ok"
}

Reset password

POST {{BASE_URL}}/api/reset-passsword

Updates the password for the user.

Headers

Name
Type
Description

Authorization*

String

Bearer Token

Request Body

Name
Type
Description

token*

String

Bearer Token

newPassword*

String

{
    "status": "ok"
}

Before registering a user, you can check if there is a user with that email address.

Check if a user with this email address exists

GET {{BASE_URL}}/api/exist-email/{email}

Check if there is a user with the specified email address.

Path Parameters

Name
Type
Description

email*

String

true | false

Last updated