On this page

Show all

Help Center/ KooDrive/ API Reference/ API/ Space Management/ Creating a Space for a Department or Individual

Creating a Space for a Department or Individual

Updated on 2025-03-07 GMT+08:00

View PDF

Function

Create a space for a department or individual.

URI

POST /koodrive/ose/v1/space/{owner_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
owner_id	Yes	String	Owner ID.

Request Parameters

**Table 2** 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 3** Request body parameters
Parameter	Mandatory	Type	Description
capacity	Yes	String	Requested space size.
type	Yes	Integer	Space type. 0: department. 1: individual.
capabilities	No	Capabilities object	User permissions.

**Table 4** Capabilities
Parameter	Mandatory	Type	Description
addChildNodePermission	Yes	Boolean	Permission to create a file or folder. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
copyPermission	Yes	Boolean	Copy permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
deletePermission	Yes	Boolean	Delete permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
downloadPermission	Yes	Boolean	Download permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
editPermission	Yes	Boolean	Edit permissions. true: granted; false: not granted (editing is not supported.)
listChildNodePermission	Yes	Boolean	Permission to view the list. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
removeChildNodePermission	Yes	Boolean	Move permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
renameFilePermission	Yes	Boolean	Rename permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
shareFilePermission	Yes	Boolean	Share permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
uploadPermission	Yes	Boolean	Upload permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.
viewPermission	Yes	Boolean	Preview permission. The value true indicates that the permission is granted, and the value false indicates that the permission is not granted.

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
data	createSpaceRspInfo object	Space information.
code	Integer	Information code.
msg	String	Information.

**Table 6** createSpaceRspInfo
Parameter	Type	Description
type	Integer	Owner type. 0: department space; 1: individual space; 2: group space.
status	Integer	Status.
ownerId	String	Space owner. For a department space, the department ID is returned. For an individual space, the user ID is returned. For a group space, the group ID is returned.
containerId	String	Space ID.
bizRootFileId	String	ID of the service root directory, which stores unencrypted common files.
bizSboxFileId	String	ID of the service safe directory, which stores encrypted files.
capacity	Integer	Space size.
spaceUsed	Integer	Size of the used space.
tenantId	String	Tenant ID.
creator	String	Creator.
modifier	String	Modifier ID.
rootFileId	String	ID of the space root directory.
operatorId	Integer	Operator ID.

Example Requests

Creates a space of 1 GB for department 1289173650183882753.

POST /koodrive/ose/v1/space/1289173650183882753

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

{
  "capacity": 1,
  "type": 0
}

Example Responses

Status code: 200

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

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

Status Codes

Status Code	Description
200	Basic response. Only the error code and error information are returned.

Parent topic: Space Management

Previous topic: Querying Space Information

Next topic: Modifying Space Information

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot