Querying the Latest Versions of All Files in a Project

Function

Query the latest versions of all files in a project.

Calling Method

For details, see Calling APIs.

URI

GET /devreposerver/v5/{project_id}/files/version

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID, which uniquely identifies a CodeArts Req project. The value is the same as that of project_id in the URL https://{host}/cloudartifact/project/{project_id}/repository on the list page of self-hosted repos. Constraints: String length: 32 characters. Value range: N/A Default value: N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
name	No	String	Definition: Name. Constraints: N/A Value range: N/A Default value: N/A
sort_by	No	String	Definition: sort_by. Constraints: N/A Value range: N/A Default value: N/A
sort_dir	No	String	Definition: sort_dir. Constraints: N/A Value range: N/A Default value: N/A
offset	No	Integer	Definition: Offset Constraints: N/A Value range: N/A Default value: N/A
limit	No	Integer	Definition: limit. Constraints: N/A Value range: N/A Default value: N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
status	String	Definition: Request status. Value range: success: The request is successful. error: The request fails.
trace_id	String	Definition: Request ID, which uniquely identifies the current request. Value range: A string of digits and hyphens (-).
result	Array of VersionViewVoV5 objects	Definition: Latest version list. Value range: N/A

**Table 4** VersionViewVoV5
Parameter	Type	Description
id	String	Definition: ID. Value range: N/A
project_id	String	Definition: Project ID. Value range: N/A
file_id	String	Definition: File ID. Value range: N/A
name	String	Definition: File name. Value range: N/A
path	String	Definition: File path. Value range: N/A

Example Requests

Query the latest versions of all files in a project.

https://{URL}/devreposerver/v5/f132b62084774001b84c294c0eef27f2/files/version

Example Responses

Status code: 200

{
  "status" : "success",
  "trace_id" : "7ca22127d0d544bebdea0115b42afa57",
  "result" : [ {
    "status" : null,
    "region" : null,
    "domain_id" : null,
    "created_time" : null,
    "modified_time" : 1747127485000,
    "created_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "created_user_name" : "devcloud_devcloud_y00226182_05",
    "created_user_nick_name" : "Repository helper",
    "created_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "modified_user_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_nick_name" : "Repository helper",
    "modified_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "id" : "0cd7f15890d84b91a27678e363ef151d",
    "project_id" : "f132b62084774001b84c294c0eef27f2",
    "file_id" : "2487edb497b44a28b07164dbd6689132",
    "name" : "_maven.repositories",
    "path" : "/11/",
    "size" : "0.0B",
    "version" : "latest",
    "version_count" : 1,
    "version_status" : "test",
    "modified_time_to_string" : "2025-05-13 17:11:25"
  }, {
    "status" : null,
    "region" : null,
    "domain_id" : null,
    "created_time" : null,
    "modified_time" : 1747126553000,
    "created_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "created_user_name" : "devcloud_devcloud_y00226182_05",
    "created_user_nick_name" : "Repository helper",
    "created_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "modified_user_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_nick_name" : "Repository helper",
    "modified_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "id" : "a3770843d8594b0a9b3a1131a613689a",
    "project_id" : "f132b62084774001b84c294c0eef27f2",
    "file_id" : "3fe9d7a21bf04df2b0159ae958b6f9ad",
    "name" : "tool_version.json",
    "path" : "/",
    "size" : "0.0B",
    "version" : "latest",
    "version_count" : 1,
    "version_status" : "test",
    "modified_time_to_string" : "2025-05-13 16:55:53"
  } ]
}