Stateset Cloud provides a REST and GraphQL API.

Authentication

It’s important to note that all data in Stateset is private by default. This means that you must authenticate with the Stateset API in order to read or write data. Stateset uses a token-based authentication system. This means that you must include your API token with every request that you make to the API. Each token depicts a user who is authenticated to your Stateset platform instance. Tokens can only be generated for signed in users and each token is tied to a particular user.

Tokens can also be generated from your Stateset Cloud Account, using tokens that are set for each user and have a variable expiry date.

A request is considered “authenticated” when the backend can securely identify which user and which device is making the request. The reasons for making authenticated requests to the backend include:

  • Associating the user with the action being performed
  • Ensuring the user has permission to make the request

Connecting to Source control

To get started, signup at cloud.stateset.app

Click the “Add New” Button in the top right corner.

  1. Connect your GitLab or GitHub Account:

First, you need to connect your GitLab or GitHub account to Stateset Cloud. This allows you to manage your serverless functions and deployments directly from your version control platform.

For GitLab:

Create a GitLab Account: If you don’t already have a GitLab account, sign up for one at gitlab.com. Create a New Project: Log in to your GitLab account and create a new project to host your serverless application code.

For GitHub: Create a GitHub Account: If you don’t already have a GitHub account, sign up for one at github.com. Create a New Repository: Create a new repository on GitHub to store your serverless project files.

  1. Import your project (GitLab)

After creating your project/repository, you need to import your existing project. Select which project you want to deploy to Stateset Cloud.

  1. Create Serverless Project