Super Admin

Endpoint

Platform super-admin tenant management, health, impersonation, and user management

POST

https://api-chat.bara.my.id

/api/super-admin/login

Authenticate a super-admin and return a JWT token (8-hour expiry).

email

string · email · required

password

string · required

JWT token

token

string

List all tenant organizations

GET

https://api-chat.bara.my.id

/api/super-admin/tenants

Returns all registered organizations. Requires super-admin auth.

List all tenant organizations › Responses

200

Array of organizations

object[]

id

string · uuid · required

name

string · required

slug

string · required

status

string · enum · required

Enum values:

provisioning

active

suspended

mongo_database

string · required

schema_version

integer · required

created_at

string · date-time · required

updated_at

string · date-time · required

limits

object

Resource limits (max_agents, max_contacts, max_messages_month)

country

string

ISO country code (e.g. ID, US)

Provision a new tenant

POST

https://api-chat.bara.my.id

/api/super-admin/tenants

Create a new tenant organization with its own databases. Requires super-admin auth.

Provision a new tenant › Request Body

name

string · required

slug

string · required

URL-safe identifier for the tenant

limits

object

country

string

admin_email

string · email

admin_password

string

Provision a new tenant › Responses

200

Created organization (provisioning in background)

id

string · uuid · required

name

string · required

slug

string · required

status

string · enum · required

Enum values:

provisioning

active

suspended

mongo_database

string · required

schema_version

integer · required

created_at

string · date-time · required

updated_at

string · date-time · required

limits

object

Resource limits (max_agents, max_contacts, max_messages_month)

country

string

ISO country code (e.g. ID, US)

POST/api/super-admin/tenants

curl --request POST \
  --url https://api-chat.bara.my.id/api/super-admin/tenants \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "slug": "slug",
  "limits": {},
  "country": "country",
  "admin_email": "test@example.com",
  "admin_password": "admin_password"
}
'

shell

Example Request Body

{
  "name": "name",
  "slug": "slug",
  "limits": {},
  "country": "country",
  "admin_email": "test@example.com",
  "admin_password": "admin_password"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "slug": "slug",
  "status": "provisioning",
  "mongo_database": "mongo_database",
  "limits": {},
  "country": "country",
  "schema_version": 0,
  "created_at": "2024-08-25T15:00:00Z",
  "updated_at": "2024-08-25T15:00:00Z"
}

json

application/json

Get a tenant organization

GET

https://api-chat.bara.my.id

/api/super-admin/tenants/{id}

Get a tenant organization › path Parameters

id

string · uuid · required

Get a tenant organization › Responses

Organization details

id

string · uuid · required

name

string · required

slug

string · required

status

string · enum · required

Enum values:

provisioning

active

suspended

mongo_database

string · required

schema_version

integer · required

created_at

string · date-time · required

updated_at

string · date-time · required

limits

object

Resource limits (max_agents, max_contacts, max_messages_month)

country

string

ISO country code (e.g. ID, US)

Suspend a tenant organization

DELETE

https://api-chat.bara.my.id

/api/super-admin/tenants/{id}

Soft-delete by setting status to suspended. Requires super-admin auth.

Suspend a tenant organization › path Parameters

id

string · uuid · required

Suspend a tenant organization › Responses

Tenant suspended

status

string

Update a tenant organization

PATCH

https://api-chat.bara.my.id

/api/super-admin/tenants/{id}

Update name, limits, or status. Requires super-admin auth.

Update a tenant organization › path Parameters

id

string · uuid · required

Update a tenant organization › Request Body

name

string

limits

object

status

string · enum

Enum values:

active

suspended

Update a tenant organization › Responses

Updated organization

id

string · uuid · required

name

string · required

slug

string · required

status

string · enum · required

Enum values:

provisioning

active

suspended

mongo_database

string · required

schema_version

integer · required

created_at

string · date-time · required

updated_at

string · date-time · required

limits

object

Resource limits (max_agents, max_contacts, max_messages_month)

country

string

ISO country code (e.g. ID, US)

Impersonate a tenant admin

POST

https://api-chat.bara.my.id

/api/super-admin/tenants/{id}/impersonate

Generate a 15-minute JWT scoped to the tenant's admin role.

Impersonate a tenant admin › path Parameters

id

string · uuid · required

Impersonate a tenant admin › Responses

Impersonation token

token

string

org_id

string · uuid

org_slug

string

expires_in_seconds

integer

List all tenants with usage statistics

GET

https://api-chat.bara.my.id

/api/super-admin/usage

Returns all organizations enriched with current usage metrics.

List all tenants with usage statistics › Responses

200

Array of tenants with usage

object[]

Organization record enriched with current usage metrics

id

string · uuid · required

name

string · required

slug

string · required

status

string · enum · required

Enum values:

provisioning

active

suspended

mongo_database

string · required

schema_version

integer · required

created_at

string · date-time · required

updated_at

string · date-time · required

limits

object

Resource limits (max_agents, max_contacts, max_messages_month)

country

string

ISO country code (e.g. ID, US)

object

GET/api/super-admin/usage

curl --request GET \
  --url https://api-chat.bara.my.id/api/super-admin/usage

shell

Example Responses

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "slug": "slug",
    "status": "provisioning",
    "mongo_database": "mongo_database",
    "limits": {},
    "country": "country",
    "schema_version": 0,
    "created_at": "2024-08-25T15:00:00Z",
    "updated_at": "2024-08-25T15:00:00Z",
    "usage": {
      "id": "00000000-0000-0000-0000-000000000000",
      "org_id": "00000000-0000-0000-0000-000000000000",
      "agent_count": 0,
      "contact_count": 0,
      "messages_this_month": 0,
      "active_integrations": 0,
      "usage_month": "2024-08-25",
      "updated_at": "2024-08-25T15:00:00Z"
    }
  }
]

json

application/json

System health check

GET

https://api-chat.bara.my.id

/api/super-admin/health

Health check for all infrastructure components (PostgreSQL, MongoDB, Redis, Kafka, MinIO) and microservices (webhook-ingestor, ws-server, ai-agent, billing-service). Also reports platform integration status and tenant counts.

System health check › Responses

200

System health report

status

string · enum · required

Enum values:

degraded

object · required

GET/api/super-admin/health

curl --request GET \
  --url https://api-chat.bara.my.id/api/super-admin/health

shell

Example Responses

{
  "status": "ok",
  "infrastructure": {
    "control_plane": {
      "status": "up"
    },
    "postgres": {
      "status": "up"
    },
    "mongodb": {
      "status": "up"
    },
    "redis": {
      "status": "up"
    },
    "kafka": {
      "status": "up"
    },
    "minio": {
      "status": "up"
    }
  },
  "microservices": {
    "api_gateway": {
      "status": "status"
    },
    "webhook_ingestor": {
      "status": "status"
    },
    "ws_server": {
      "status": "status"
    },
    "chat_engine": {
      "status": "status"
    },
    "message_sender": {
      "status": "status"
    },
    "ai_agent": {
      "status": "status"
    },
    "billing_service": {
      "status": "status"
    }
  },
  "platforms": {
    "whatsapp": {
      "status": "active"
    },
    "instagram": {
      "status": "active"
    },
    "messenger": {
      "status": "active"
    },
    "email": {
      "status": "active"
    }
  },
  "tenants": {
    "total": 0,
    "active": 0,
    "suspended": 0
  }
}

json

application/json

List super-admin accounts

GET

https://api-chat.bara.my.id

/api/super-admin/admins

List super-admin accounts › Responses

200

Array of super-admin accounts (password excluded)

object[]

id

string · uuid

email

string · email

name

string

created_at

string · date-time

Create a super-admin account

POST

https://api-chat.bara.my.id

/api/super-admin/admins

Create a super-admin account › Request Body

email

string · email · required

name

string · required

password

string · minLength: 8 · required

Create a super-admin account › Responses

Created super-admin

id

string · uuid

email

string

name

string

Delete a super-admin account

DELETE

https://api-chat.bara.my.id

/api/super-admin/admins/{id}

Cannot delete your own account.

Delete a super-admin account › path Parameters

id

string · uuid · required

Delete a super-admin account › Responses

Deleted

status

string

Reset a super-admin's password

POST

https://api-chat.bara.my.id

/api/super-admin/admins/{id}/reset-password

Reset a super-admin's password › path Parameters

id

string · uuid · required

Reset a super-admin's password › Request Body

new_password

string · minLength: 8 · required

Reset a super-admin's password › Responses

Password reset

status

string

List tenant users

GET

https://api-chat.bara.my.id

/api/super-admin/users

List agents in a tenant, optionally filtered by search term.

List tenant users › query Parameters

tenant_id

string · uuid · required

search

string

Filter by email or name (ILIKE)

List tenant users › Responses

200

Array of tenant users

object[]

id

string · uuid

email

string

full_name

string

role

string

is_online

boolean

last_seen_at

string · date-time

created_at

string · date-time

Reset a tenant user's password

POST

https://api-chat.bara.my.id

/api/super-admin/users/{id}/reset-password

Reset a tenant user's password › path Parameters

id

string · uuid · required

Reset a tenant user's password › query Parameters

tenant_id

string · uuid · required

Reset a tenant user's password › Request Body

new_password

string · minLength: 8 · required

Reset a tenant user's password › Responses

200

Password reset

status

string

Suspend a tenant user

POST

https://api-chat.bara.my.id

/api/super-admin/users/{id}/suspend

Suspend a tenant user › path Parameters

id

string · uuid · required

Suspend a tenant user › query Parameters

tenant_id

string · uuid · required

Suspend a tenant user › Responses

200

User suspended

status

string

Activate a tenant user

POST

https://api-chat.bara.my.id

/api/super-admin/users/{id}/activate

Activate a tenant user › path Parameters

id

string · uuid · required

Activate a tenant user › query Parameters

tenant_id

string · uuid · required

Activate a tenant user › Responses

200

User activated

status

string

Impersonate a tenant user

POST

https://api-chat.bara.my.id

/api/super-admin/users/{id}/impersonate

Generate a 15-minute JWT for a specific tenant user.

Impersonate a tenant user › path Parameters

id

string · uuid · required

Impersonate a tenant user › query Parameters

tenant_id

string · uuid · required

Impersonate a tenant user › Responses

Impersonation token

token

string

agent_id

string · uuid

email

string

role

string

expires_in_seconds

integer

Working Hours Billing Admin

Super Admin

Super-admin login

Super-admin login › Request Body

Super-admin login › Responses

List all tenant organizations

List all tenant organizations › Responses

Provision a new tenant

Provision a new tenant › Request Body

Provision a new tenant › Responses

Get a tenant organization

Get a tenant organization › path Parameters

Get a tenant organization › Responses

Suspend a tenant organization

Suspend a tenant organization › path Parameters

Suspend a tenant organization › Responses

Update a tenant organization

Update a tenant organization › path Parameters

Update a tenant organization › Request Body

Update a tenant organization › Responses

Impersonate a tenant admin

Impersonate a tenant admin › path Parameters

Impersonate a tenant admin › Responses

List all tenants with usage statistics

List all tenants with usage statistics › Responses

System health check

System health check › Responses

List super-admin accounts

List super-admin accounts › Responses

Create a super-admin account

Create a super-admin account › Request Body

Create a super-admin account › Responses

Delete a super-admin account

Delete a super-admin account › path Parameters

Delete a super-admin account › Responses

Reset a super-admin's password

Reset a super-admin's password › path Parameters

Reset a super-admin's password › Request Body

Reset a super-admin's password › Responses

List tenant users

List tenant users › query Parameters

List tenant users › Responses

Reset a tenant user's password

Reset a tenant user's password › path Parameters

Reset a tenant user's password › query Parameters

Reset a tenant user's password › Request Body

Reset a tenant user's password › Responses

Suspend a tenant user

Suspend a tenant user › path Parameters

Suspend a tenant user › query Parameters

Suspend a tenant user › Responses

Activate a tenant user

Activate a tenant user › path Parameters

Activate a tenant user › query Parameters

Activate a tenant user › Responses

Impersonate a tenant user

Impersonate a tenant user › path Parameters

Impersonate a tenant user › query Parameters

Impersonate a tenant user › Responses