Users API

Manage users and permissions

The Users API allows you to manage team members in your organization. You can invite users, assign roles, and control access to your bots and groups.

User Roles

CLIENT_OWNER

Full access to organization

CLIENT_ADMIN

Admin access, cannot delete org

CLIENT_VIEWER

Read-only access

BOT_USER

Telegram bot users

Endpoints

GET
/api/users

List all users in your organization

pagelimitrolesearch
GET
/api/users/:id

Get details of a specific user

id
GET
/api/users/me

Get the authenticated user profile

PATCH
/api/users/:id

Update user details or role

namerolestatus
DELETE
/api/users/:id

Remove a user from the organization

id

Example: Get Current User

curl https://api.botlaunch.io/api/users/me \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "data": {
    "id": "usr_abc123",
    "email": "john@example.com",
    "name": "John Doe",
    "role": "CLIENT_OWNER",
    "organizationId": "org_xyz789"
  }
}

Next: Webhooks API

Learn how to receive real-time updates via webhooks.

Webhooks API