This reference covers the APIs for managing users in Eden-MDBS.
Users are members of an organization with specific access permissions. Each user has credentials for authentication and can be assigned various access levels to resources.
Create a new user in your organization.
POST /api/v1/iam/users
Content-Type: application/json
Authorization: Bearer <token>| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | User identifier (email or ID) |
password | string | Yes | User password |
curl http://{host}:8000/api/v1/iam/users \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
"id": "developer@company.com",
"password": "secure_password_123"
}'{
"status": "success",
"data": {
"message": "User created successfully"
}
}Retrieve details for a specific user.
GET /api/v1/iam/users/{user}
Authorization: Bearer <token>| Parameter | Type | Description |
|---|---|---|
user | string | User identifier |
curl http://{host}:8000/api/v1/iam/users/developer@company.com \
-H "Authorization: Bearer $TOKEN"{
"status": "success",
"data": {
"id": "developer@company.com",
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z"
}
}Update an existing user's information.
PATCH /api/v1/iam/users/{user}
Content-Type: application/json
Authorization: Bearer <token>| Field | Type | Required | Description |
|---|---|---|---|
password | string | No | New password |
curl http://{host}:8000/api/v1/iam/users/developer@company.com \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X PATCH \
-d '{
"password": "new_secure_password_456"
}'{
"status": "success",
"data": {
"message": "User updated successfully"
}
}Remove a user from your organization.
DELETE /api/v1/iam/users/{user}
Authorization: Bearer <token>| Parameter | Type | Description |
|---|---|---|
user | string | User identifier |
curl http://{host}:8000/api/v1/iam/users/developer@company.com \
-H "Authorization: Bearer $TOKEN" \
-X DELETEReturns 204 No Content on success.
Eden supports two formats for user identification:
Use email addresses or custom user identifiers:
{
"id": "john.doe@company.com"
}Use UUID format for user identification:
{
"id": "550e8400-e29b-41d4-a716-446655440000"
}The system automatically detects the format:
| Operation | Required Access |
|---|---|
| Create user | Admin |
| Get user | Admin |
| Update user | Admin |
| Delete user | Admin |
{
"error": "Conflict",
"message": "User already exists"
}{
"error": "Not Found",
"message": "User not found"
}{
"error": "Bad Request",
"message": "Password does not meet requirements"
}{
"error": "Forbidden",
"message": "Admin access required to manage users"
}