RESTful API Help

Query Basic Info

Http Method

GET

End Point

/~api/builds

Query Parameters

Parameter	Description	Required	Example
query	Syntax of this query is the same as in builds page	No	"Job" is "Release"
offset	Offset	Yes	0
count	Count	Yes	100

Response

Operation Successful

Status Code

200

Response Body

Content Type: application/json
Example: [ {

"id" : 1 ,
"numberScopeId" : 1 ,
"projectId" : 1 ,
"agentId" : 1 ,
"submitterId" : 1 ,
"cancellerId" : 1 ,
"jobName" : "string" ,
"workspacePath" : "string" ,
"checkoutPaths" : [ "string" ] ,
"refName" : "string" ,
"version" : "string" ,
"description" : "string" ,
"uuid" : "string" ,
"number" : 1 ,
"commitHash" : "string" ,
"status" : "WAITING" ,
"paused" : true ,
"submitDate" : "2025-01-18T07:55:34.479+00:00" ,
"pendingDate" : "2025-01-18T07:55:34.479+00:00" ,
"runningDate" : "2025-01-18T07:55:34.479+00:00" ,
"finishDate" : "2025-01-18T07:55:34.479+00:00" ,
"pendingDuration" : 1 ,
"runningDuration" : 1 ,
"retryDate" : "2025-01-18T07:55:34.479+00:00" ,
"finishTimeGroups" : {

"day" : 1 ,
"week" : 1 ,
"month" : 1

} ,
"submitReason" : "string" ,
"requestId" : 1 ,
"issueId" : 1

} ]

Operation Failed

Status code: Status code other than 200 indicating the error type
Response Body: Error detail of content type "text/plain"

cURL Example

$ curl -u <login name>:<password or access token> -G https://git.codedune.app/~api/builds --data-urlencode 'query="Job" is "Release"' --data-urlencode offset=0 --data-urlencode count=100