Adding Album Content

Function

Add contents. Add associated contents to a manual album instead of uploading files.

URI

POST /koodrive/ose/v1/album/{albumId}/add

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
albumId	Yes	String	Definition: Album ID. Constraints: Use the ID returned after an album is created. Range: N/A Default Value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Authorization	Yes	String	Definition: 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}. Constraints: N/A Range: N/A Default Value: N/A
X-User-Id	Yes	String	Definition: User ID on KooDrive, which is used for app authentication. Constraints: N/A Range: N/A Default Value: N/A
X-Date	Yes	String	Definition: Date, which is used for app authentication. Constraints: The format is yyyyMMDD'T'HHmmss'Z', for example, 20251103T070140Z. Range: The value must be within 15 minutes from the current time and cannot be later than the current time. Default Value: N/A
X-Traceid	No	String	Definition: Service trace ID, which contains 58 bits. Constraints: N/A Range: The value contains 58 bits. Default Value: N/A
language	No	String	Definition: Language code. Constraints: The value must comply with the internationalization specifications. For example, en_us indicates English (United States). Range: N/A Default Value If this parameter is not transferred, English (United States) is used by default.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
fileIds	Yes	Array of fileMap objects	Definition: List of files to be added to a manual album. Constraints: N/A Range: The maximum list length is 100. Default Value: N/A

**Table 4** fileMap
Parameter	Mandatory	Type	Description
fileId	Yes	String	Definition: File ID. Constraints: The maximum length is 64 bits. Range: N/A Default Value: N/A
ownerId	Yes	String	Definition: File owner ID. Constraints: N/A Range: N/A Default Value: N/A

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
code	Integer	Response code.
msg	String	Response.

Example Requests

Request for adding contents to an album.

/koodrive/ose/v1/album/1795607640592646273/add

{
  "fileIds" : [ {
    "fileId" : "FsCjgqsA1KCDDMPOsOkNDFKhXmUNCNrkg",
    "ownerId" : "154663352556663635"
  } ]
}