Users

Download schema

User management endpoints

Get your current user

GET

https://app.monad.com/api

/v1/users

Authorization (header)

Required Permissions: None (authentication only)

Get your current user

Get your current user › query Parameters

organization_id

string · required

Organization ID

Get your current user › Responses

Get user successful

routes.UserWithRoles

routes.UserAuthProvider

created_at

string

email

string

id

string

models.UserRoleWithPermissions

updated_at

string

username

string

GET/v1/users

curl 'https://app.monad.com/api/v1/users?organization_id=<string>' \
  --header 'Authorization: <api-key>'

Example Responses

{
  "auth_provider": {
    "id": "id",
    "provider": "provider",
    "provider_id": "provider_id"
  },
  "created_at": "created_at",
  "email": "email",
  "id": "id",
  "organization_role": {
    "inherited": true,
    "organization_id": "organization_id",
    "permissions": [
      {
        "created_at": "created_at",
        "description": "description",
        "id": "id",
        "name": "name",
        "slug": "slug",
        "updated_at": "updated_at"
      }
    ],
    "role_id": "role_id",
    "role_name": "role_name",
    "source_organization_id": "source_organization_id"
  },
  "updated_at": "updated_at",
  "username": "username"
}

json

application/json

Create user

POST

https://app.monad.com/api

/v1/users

Authorization (header)

x-api-key (header)

Required Permissions: None (authentication only)

Create user

Create user › Request Body

Create user › Responses

Get user success

github_com_monad-inc_core_pkg_types_models.User

models.UserAuthProvider[]

created_at

string

email

string

id

string

updated_at

string

username

string

Get MFA status

GET

https://app.monad.com/api

/v3/users/mfa

Authorization (header)

x-api-key (header)

Required Permissions: None (authentication only)

Get MFA enrollment status and methods for a user

Get MFA status › Responses

MFA status retrieved successfully

routesV3.MFAStatusResponse

enabled

boolean

authenticationtypes.AuthenticationMethod[]

Enable MFA

POST

https://app.monad.com/api

/v3/users/mfa

Authorization (header)

x-api-key (header)

Required Permissions: None (authentication only)

Enable MFA for a user and create enrollment ticket (OTP only)

Enable MFA › Responses

MFA enrollment ticket created successfully

authenticationtypes.MFAEnrollmentTicket

ticket_id

string

ticket_url

string

Alert Rules Organizations

Get your current user

GET

https://app.monad.com/api

/v1/users

Authorization (header)

Required Permissions: None (authentication only)

Get your current user

Get your current user › query Parameters

organization_id

string · required

Organization ID

Get your current user › Responses

Get user successful

routes.UserWithRoles

routes.UserAuthProvider

created_at

string

email

string

id

string

models.UserRoleWithPermissions

updated_at

string

username

string

Create user

POST

https://app.monad.com/api

/v1/users

Authorization (header)

x-api-key (header)

Required Permissions: None (authentication only)

Create user

Create user › Request Body

Create user › Responses

Get user success

github_com_monad-inc_core_pkg_types_models.User

models.UserAuthProvider[]

created_at

string

email

string

id

string

updated_at

string

username

string

Get MFA status

GET

https://app.monad.com/api

/v3/users/mfa

Authorization (header)

x-api-key (header)

Required Permissions: None (authentication only)

Get MFA enrollment status and methods for a user

Get MFA status › Responses

MFA status retrieved successfully

routesV3.MFAStatusResponse

enabled

boolean

authenticationtypes.AuthenticationMethod[]

Enable MFA

POST

https://app.monad.com/api

/v3/users/mfa

Authorization (header)

x-api-key (header)

Required Permissions: None (authentication only)

Enable MFA for a user and create enrollment ticket (OTP only)

Enable MFA › Responses

MFA enrollment ticket created successfully

authenticationtypes.MFAEnrollmentTicket

ticket_id

string

ticket_url

string