curl --request POST \
--url 'https://YOURSITE.konstant.ly/openapi/v1/users' \
--header 'X-API-KEY: 1qaz2wsx3edc4rfv1qaz2wsx3edc4rfv' \
--header 'Content-Type: application/json' \
--data '{
"name": "Jason Wunderliebb",
"email": "j.wunderliebb@mycompany.tld",
"password": "VerySecurePas$w0rd!",
"roleAlias": "learner",
"bio": "Hi folks! I love to sell and teach about sales.",
"occupation": "Associate",
"location": "London",
"timezone": "Europe/London",
"fromApi": false,
"courses": [110, 150],
"deadlineAt": 1234567890,
"groups": [2],
"attributes": {
"designation": 4,
"department": 15,
"mobile_number": "+44 0 144 44 444"
}
}'

import requests
from typing import List, Dict, Optional

class UserAPI:
def __init__(self, api_key: str):
self.api_key = api_key
self.base_url = "https://YOURSITE.konstant.ly/openapi/v1"

def create_user(
self,
name: str,
email: str,
password: str,
role_alias: str,
occupation: Optional[str] = None,
location: Optional[str] = None,
timezone: Optional[str] = None,
bio: Optional[str] = None,
from_api: bool = True,
courses: Optional[List[int]] = None,
deadline_at: Optional[int] = None,
groups: Optional[List[int]] = None,
attributes: Optional[Dict] = None
) -> dict:
url = f"{self.base_url}/users"

data = {
"name": name,
"email": email,
"password": password,
"roleAlias": role_alias,
"fromApi": from_api
}

# Add optional fields if provided
if occupation:
data["occupation"] = occupation
if location:
data["location"] = location
if timezone:
data["timezone"] = timezone
if bio:
data["bio"] = bio
if courses:
data["courses"] = courses
if deadline_at:
data["deadlineAt"] = deadline_at
if groups:
data["groups"] = groups
if attributes:
data["attributes"] = attributes

headers = {
"X-API-KEY": self.api_key,
"Content-Type": "application/json"
}

try:
response = requests.post(url, headers=headers, json=data)

if response.status_code == 400:
error_data = response.json()
print("Validation errors:")
for field, errors in error_data.get('errors', {}).items():
print(f"{field}: {', '.join(errors)}")
raise ValueError(error_data.get('message', 'Invalid request'))

response.raise_for_status()
return response.json()

except requests.exceptions.RequestException as e:
print(f"Error creating user: {str(e)}")
if hasattr(e, 'response') and e.response is not None:
print(f"Response: {e.response.text}")
raise

# Example usage
if __name__ == "__main__":
api = UserAPI("1qaz2wsx3edc4rfv1qaz2wsx3edc4rfv")

try:
user = api.create_user(
name="Jason Wunderliebb",
email="j.wunderliebb@mycompany.tld",
password="VerySecurePas$w0rd!",
role_alias="learner",
occupation="Associate",
location="London",
timezone="Europe/London",
bio="Hi folks! I love to sell and teach about sales.",
from_api=False,
courses=[110, 150],
deadline_at=1234567890,
groups=[2],
attributes={
"designation": 4,
"department": 15,
"mobile_number": "+44 0 144 44 444"
}
)

print("User created successfully!")
print(f"ID: {user['id']}")
print(f"Name: {user['name']}")
print(f"Email: {user['email']}")

except Exception as e:
print(f"Failed to create user: {str(e)}")

const axios = require('axios');

class UsersAPI {
constructor(apiKey) {
this.client = axios.create({
baseURL: 'https://YOURSITE.konstant.ly/openapi/v1',
headers: {
'X-API-KEY': apiKey,
'Content-Type': 'application/json'
}
});
}

async createUser({
name,
email,
password,
roleAlias,
bio,
occupation,
location,
timezone,
fromApi = true,
courses,
deadlineAt,
groups,
attributes
}) {
try {
const response = await this.client.post('/users', {
name,
email,
password,
roleAlias,
bio,
occupation,
location,
timezone,
fromApi,
courses,
deadlineAt,
groups,
attributes
});

return response.data;
} catch (error) {
if (error.response) {
if (error.response.status === 400) {
console.error('Validation errors:');
const errors = error.response.data.errors || {};
Object.entries(errors).forEach(([field, messages]) => {
console.error(`${field}: ${messages.join(', ')}`);
});
throw new Error(error.response.data.message || 'Invalid request');
}
throw new Error(`Failed to create user: ${error.response.data.message || error.message}`);
}
throw error;
}
}
}

// Example usage
async function main() {
const usersApi = new UsersAPI('1qaz2wsx3edc4rfv1qaz2wsx3edc4rfv');

try {
const user = await usersApi.createUser({
name: "Jason Wunderliebb",
email: "j.wunderliebb@mycompany.tld",
password: "VerySecurePas$w0rd!",
roleAlias: "learner",
bio: "Hi folks! I love to sell and teach about sales.",
occupation: "Associate",
location: "London",
timezone: "Europe/London",
fromApi: false,
courses: [110, 150],
deadlineAt: 1234567890,
groups: [2],
attributes: {
designation: 4,
department: 15,
mobile_number: "+44 0 144 44 444"
}
});

console.log('User created successfully!');
console.log(`ID: ${user.id}`);
console.log(`Name: ${user.name}`);
console.log(`Email: ${user.email}`);

} catch (error) {
console.error('Failed to create user:', error.message);
}
}

main();

{
    "id": "1234567890",
    "name": "Jason Wunderliebb",
    "language": "en",
    "occupation": "Associate",
    "location": "London",
    "timezone": "Europe/London",
    "email": "j.wunderliebb@mycompany.tld",
    "isBanned": false,
    "role": {
    "alias": "learner"
},
    "fromApi": false,
    "image": null,
    "attributes": {
    "designation": 4,
    "department": 15,
    "mobile_number": "+44 0 144 44 444"
}
}

{
    "status": 400,
    "message": "Validation failed",
    "errors": {
    "email": ["Email is already taken"],
    "password": ["Password must be at least 8 characters"]
}
}