User Endpoints
User Management
Create User
1POST /api/v1/users2Authorization: Bearer <token>3Content-Type: application/json45{6 "email": "newuser@example.com",7 "name": "Jane Smith",8 "password": "secure-password",9 "roles": ["developer"]10}Response:
1{2 "user_id": "usr_456",3 "email": "newuser@example.com",4 "name": "Jane Smith",5 "roles": ["developer"],6 "created_at": "2024-01-07T12:00:00Z"7}List Users
1GET /api/v1/users?limit=50&offset=02Authorization: Bearer <token>Response:
1{2 "users": [3 {4 "user_id": "usr_123",5 "email": "user@example.com",6 "name": "John Doe",7 "roles": ["admin"],8 "created_at": "2024-01-01T00:00:00Z"9 }10 ],11 "total": 15,12 "limit": 50,13 "offset": 014}Get User
1GET /api/v1/users/:user_id2Authorization: Bearer <token>Update User
1PUT /api/v1/users/:user_id2Authorization: Bearer <token>3Content-Type: application/json45{6 "name": "John Updated",7 "roles": ["admin", "developer"]8}Delete User
1DELETE /api/v1/users/:user_id2Authorization: Bearer <token>Change Password
1POST /api/v1/users/:user_id/password2Authorization: Bearer <token>3Content-Type: application/json45{6 "currentPassword": "old-password",7 "newPassword": "new-secure-password"8}Reset Password
1POST /api/v1/users/:user_id/password/reset2Authorization: Bearer <token>Lock User Account
1POST /api/v1/users/:user_id/lock2Authorization: Bearer <token>Assign Roles
1POST /api/v1/users/:user_id/roles2Authorization: Bearer <token>3Content-Type: application/json45{6 "roles": ["admin", "developer"]7}Get User Activity
1GET /api/v1/users/:user_id/activity2Authorization: Bearer <token>Get User Preferences
1GET /api/v1/users/:user_id/preferences2Authorization: Bearer <token>Update User Preferences
1PUT /api/v1/users/:user_id/preferences2Authorization: Bearer <token>3Content-Type: application/json45{6 "theme": "dark",7 "notifications": true,8 "timezone": "America/New_York"9}Next Steps
- Organizations — Organization and team management
- Authentication — JWT, OAuth 2.0, and Device Flow
- Errors & Limits — Error handling and rate limiting