Users

Manage user accounts and profiles.

GET/v1/users

List all users with pagination.

Name	Type	Required	Description
page	integer	optional	Page number (default: 1)
per_page	integer	optional	Items per page (default: 25, max: 100)
search	string	optional	Search by name or email

{ "data": [{ "id": "usr_123", "name": "Jane Doe", "email": "jane@example.com", "role": "developer" }], "meta": { "total": 1420 } }

GET/v1/users/:id

Retrieve a specific user by ID.

Name	Type	Required	Description
id	string	required	The user ID

{ "id": "usr_123", "name": "Jane Doe", "email": "jane@example.com", "role": "developer", "created_at": "2025-01-15T10:30:00Z" }

PUT/v1/users/:id

Update a user profile.

{ "name": "Jane Updated", "bio": "Full stack developer" }

{ "id": "usr_123", "name": "Jane Updated", "bio": "Full stack developer", "updated_at": "2025-03-10T08:00:00Z" }

DELETE/v1/users/:id

Deactivate a user account.

Name	Type	Required	Description
id	string	required	The user ID

{ "success": true, "message": "User deactivated" }