Users

User management operations

Get current user

get

http://localhost:3000/api/v1https://e-commerce-api.deephiwase.xyz/api/v1

/users/current

Retrieves the currently authenticated user's information.

Authorizations

cookieAuth

accessTokenstringRequired

Responses

200

Current user's information.

application/json

_idstring · objectidRead-onlyOptional

Unique identifier for the users

emailstring · emailOptional

User's email address.

rolestring · enumOptional

The role of the user.

Possible values:

verifiedbooleanOptional

Whether the user's email is verified.

createdAtstring · date-timeOptional

The date and time the user was created.

updatedAtstring · date-timeOptional

The date and time the user was last updated.

401

Unauthorized.

get

/users/current

HTTPcURLJavaScriptPython

GET /api/v1/users/current HTTP/1.1
Host: localhost:3000
Accept: */*

{
  "_id": "text",
  "email": "[email protected]",
  "role": "retailer",
  "verified": true,
  "createdAt": "2026-03-16T19:11:03.366Z",
  "updatedAt": "2026-03-16T19:11:03.366Z"
}

Update current user

put

http://localhost:3000/api/v1https://e-commerce-api.deephiwase.xyz/api/v1

/users/current

Updates the currently authenticated user's information.

Authorizations

cookieAuth

accessTokenstringRequired

Body

application/json

emailstring · emailOptional

User's new email address.

passwordstring · passwordOptional

User's new password (at least 6 characters).

Responses

200

User updated successfully.

No content

400

Bad request (e.g., invalid input).

401

Unauthorized.

put

/users/current

HTTPcURLJavaScriptPython

PUT /api/v1/users/current HTTP/1.1
Host: localhost:3000
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "email": "[email protected]",
  "password": "password"
}

No content

Delete current user

delete

http://localhost:3000/api/v1https://e-commerce-api.deephiwase.xyz/api/v1

/users/current

Deletes the currently authenticated user's account.

Authorizations

cookieAuth

accessTokenstringRequired

Responses

200

User deleted successfully.

No content

401

Unauthorized.

delete

/users/current

HTTPcURLJavaScriptPython

DELETE /api/v1/users/current HTTP/1.1
Host: localhost:3000
Accept: */*

No content

Get all users

get

http://localhost:3000/api/v1https://e-commerce-api.deephiwase.xyz/api/v1

/users

Retrieves a list of all users (admin only).

Authorizations

cookieAuth

accessTokenstringRequired

Query parameters

limitintegerOptional

The number of users to return.

Default: 10

offsetintegerOptional

The number of users to skip.

Default: 0

Responses

200

A list of users.

application/json

_idstring · objectidRead-onlyOptional

Unique identifier for the users

emailstring · emailOptional

User's email address.

rolestring · enumOptional

The role of the user.

Possible values:

verifiedbooleanOptional

Whether the user's email is verified.

createdAtstring · date-timeOptional

The date and time the user was created.

updatedAtstring · date-timeOptional

The date and time the user was last updated.

401

Unauthorized.

403

Forbidden.

get

/users

HTTPcURLJavaScriptPython

GET /api/v1/users HTTP/1.1
Host: localhost:3000
Accept: */*

[
  {
    "_id": "text",
    "email": "[email protected]",
    "role": "retailer",
    "verified": true,
    "createdAt": "2026-03-16T19:11:03.366Z",
    "updatedAt": "2026-03-16T19:11:03.366Z"
  }
]

Get user by ID

get

http://localhost:3000/api/v1https://e-commerce-api.deephiwase.xyz/api/v1

/users/{userId}

Retrieves a user by their ID (admin only).

Authorizations

cookieAuth

accessTokenstringRequired

Path parameters

userIdstringRequired

The ID of the user to retrieve.

Responses

200

The user's information.

application/json

_idstring · objectidRead-onlyOptional

Unique identifier for the users

emailstring · emailOptional

User's email address.

rolestring · enumOptional

The role of the user.

Possible values:

verifiedbooleanOptional

Whether the user's email is verified.

createdAtstring · date-timeOptional

The date and time the user was created.

updatedAtstring · date-timeOptional

The date and time the user was last updated.

401

Unauthorized.

403

Forbidden.

404

Not found.

get

/users/{userId}

HTTPcURLJavaScriptPython

GET /api/v1/users/{userId} HTTP/1.1
Host: localhost:3000
Accept: */*

{
  "_id": "text",
  "email": "[email protected]",
  "role": "retailer",
  "verified": true,
  "createdAt": "2026-03-16T19:11:03.366Z",
  "updatedAt": "2026-03-16T19:11:03.366Z"
}

Delete user by ID

delete

http://localhost:3000/api/v1https://e-commerce-api.deephiwase.xyz/api/v1

/users/{userId}

Deletes a user by their ID (admin only).

Authorizations

cookieAuth

accessTokenstringRequired

Path parameters

userIdstringRequired

The ID of the user to delete.

Responses

200

User deleted successfully.

No content

401

Unauthorized.

403

Forbidden.

404

Not found.

delete

/users/{userId}

HTTPcURLJavaScriptPython

DELETE /api/v1/users/{userId} HTTP/1.1
Host: localhost:3000
Accept: */*

No content