Skip to main content

Sub-users

Sub-users are API users. While you can use the super-user for single-user projects, it is recommended to create sub-users for multi-user projects and assign privileges per table.

Create a new sub-user​

Create a new sub-user
POST https://api.centia.io/api/v4/users HTTP/1.1
Content-Type: application/json
Authorization: Bearer abc123

{
    "name": "alx",
    "email": "alx@gunsnroses.com",
    "password": "Paradise_City!%Rck1987"
}
Create multiple sub-users
POST https://api.centia.io/api/v4/users HTTP/1.1
Content-Type: application/json
Authorization: Bearer abc123

[
    {
        "name": "alx",
        "email": "alx@gunsnroses.com",
        "password": "Paradise_City!%Rck1987"
    },
    {
        "name": "slash",
        "email": "slash@gunsnroses.com",
        "password": "November_Rain!%Pno1991"
    },
    {
        "name": "izzy",
        "email": "izzy@gunsnroses.com",
        "password": "KnockinOn_HeavensDoor!%GnR1990"
    },
    {
        "name": "duff",
        "email": "duff@gunsnroses.com",
        "password": "Welcome2_Jungle!%AxL1987"
    },
    {
        "name": "steven",
        "email": "steven@gunsnroses.com",
        "password": "SweetChild_oMine!%Gtr1987"
    }
]

Get sub-users​

Get specific sub-users
GET https://api.centia.io/api/v4/users/alx,slash HTTP/1.1
Accept: application/json; charset=utf-8
Authorization: Bearer abc123
Get all sub-users
GET https://api.centia.io/api/v4/users HTTP/1.1
Accept: application/json; charset=utf-8
Authorization: Bearer abc123

Update sub-users​

It is not possible to update all sub-users in a single operation. You must specify the sub-users explicitly.

Update specific sub-users
PATCH https://api.centia.io/api/v4/users/alx,slash HTTP/1.1
Content-Type: application/json
Authorization: Bearer abc123

{
    "user_group": "gunsnroses"
}

Delete sub-users​

It is not possible to delete all sub-users in a single operation. You must specify the sub-users explicitly.

Delete specific sub-users
DELETE https://api.centia.io/api/v4/users/izzy,steven HTTP/1.1
Accept: application/json; charset=utf-8
Authorization: Bearer abc123

Signup (Browser – Create a new user)​

Centia.io supports signup via the browser. From your app, you can redirect the user to the signup page:

https://api.centia.io/signup?client_id=abc123&parentdb=mydb&redirect_uri=https://myapp.com/login

Parameters:

  • client_id: OAuth client id configured in Centia.io
  • parentdb: The parent/tenant database under which the new user should be created
  • redirect_uri: URL in your app to return to after sign‑up

The SDK has a helper function to redirect the user to the signup page.

note
  • After the user completes sign-up and is redirected back to your app, start your normal sign-in flow (for example, CodeFlow). A session is already started, so the user is typically signed in automatically.
  • Client property allow_signup must be set to true for the used OAuth client.
  • Client property social_signup must be set to true for users to sign up with social login.