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

201: Created

{
    "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

201: Created

{
    "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

200: OK

{
    "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

200: OK

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

Refresh token

GET {{BASE_URL}}/api/refresh

Update jwt tokens.

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{
    "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

200: OK

{
    "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

200: OK

{
    "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

200: OK

true | false