Help Center/ KooDrive/ API Reference/ API/ User Management/ Creating a User
Updated on 2025-10-22 GMT+08:00
View PDF
Share

Creating a User

Function

Create a user.

Authorization Information

No identity policy-based permission required for calling this API.

URI

POST /koodrive/ose/v1/users

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

Authorization

Yes

String

Access token. Token authentication is used to call KooDrive APIs. A token indicates the permission. When an API is called, the token is added to the request header to obtain the operation permission. For details about how to obtain an access token, see the corresponding developer guide. The format is Bearer+{access_token}.

X-User-Id

Yes

String

User ID, which is used for app authentication.

X-Date

Yes

String

Date, which is used for app authentication.

Host

Yes

String

Address, which is used for app authentication.

X-Traceid

No

String

Message log trace ID. The value contains 58 bits.

language

No

String

Language code, which complies with the internationalization specifications. For example, en-US indicates English (United States). English (United States) is used by default.
Table 2 Request body parameters

Parameter

Mandatory

Type

Description

userId

Yes

String

User ID.

modifyUserInfoReq

Yes

modifyUserInfoReq object

Request for modifying user information.
Table 3 modifyUserInfoReq

Parameter

Mandatory

Type

Description

deptId

No

String

Department ID.

role

No

String

Role. 0: department administrator; 1: common user; 2: super administrator; 3: cloud drive administrator; 5: manageable members

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

data

DeptData object

Message body.

code

Integer

Information code.

msg

String

Information.
Table 5 DeptData

Parameter

Type

Description

id

String

Department ID.

Example Requests

Creates a user whose userId in OrgID is 1008600000029937613.

POST /koodrive/ose/v1/users

Authorization:Bearer+10f88**********4791e9ff

{
  "userId": "1008600000029937613"
}

Example Responses

Status code: 200

Basic response. Only the error code and error information are returned.

{
  "code" : 0,
  "msg" : "success"
}

Status Codes

Status Code

Description

200

Basic response. Only the error code and error information are returned.
Parent topic: User Management