Updated on 2026-09-21 GMT+08:00

Updating Enterprise Projects That Are Added to Favorites

Function

This API is used to update enterprise projects that are added to favorites.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

coc::updateEpsCollection

Write

-

-

coc:enterpriseProject:updateCollect

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
coc::updateEpsCollection	Write	-	-	coc:enterpriseProject:updateCollect	-

URI

PUT /v1/enterprise-project-collect

Request Parameters

**Table 1** Request body parameters
Parameter	Mandatory	Type	Description
id	Yes	String	Definition Unique ID. Constraints N/A Range N/A Default value N/A
ep_id_list	Yes	Array of strings	Definition List of selected enterprise projects added to favorites. Constraints N/A Range N/A Default value N/A
user_id	No	String	Definition User ID. Range N/A

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
data	String	Definition UUID allocated by COC-CMDB. Range N/A

Example Requests

Update the enterprise projects that are added to favorites.

PUT https://{Endpoint}/v1/enterprise-project-collect

{
  "id" : "67f377fb82f8e23d90f75574",
  "user_id" : "653989085ba7487184d7cf219b8aa51e",
  "ep_id_list" : [ "0", "a30b64a9-4b25-46b1-b063-ed477ee94069", "fae3f65d-43b1-4ec6-bd0f-ba23c3d1df05", "ba2d2a6a-6d15-464b-9ba3-278919a78e82" ]
}

Example Responses

Status code: 200

{
  "data" : "67f377fb82f8e23d90f75574"
}

Status Codes

Status Code	Description
200	The enterprise projects that are added to favorites are updated.

Error Codes

See Error Codes.

Parent topic: Enterprise Projects