Move a pull request to the front of an application's merge train
import requests
url = "https://platform.ankra.app/api/v1/org/applications/{application_id}/merge-train/entries/{entry_id}/front"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/org/applications/{application_id}/merge-train/entries/{entry_id}/front', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://platform.ankra.app/api/v1/org/applications/{application_id}/merge-train/entries/{entry_id}/front \
--header 'Authorization: Bearer <token>'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pull_request_number": 123,
"pull_request_head_sha": "<string>",
"pull_request_title": "<string>",
"base_branch": "<string>",
"status": "queued",
"position": 123,
"attempt": 123,
"requested_by": "<string>",
"requested_via": "api",
"enqueued_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"car_branch": "<string>",
"car_base_sha": "<string>",
"car_commit_sha": "<string>",
"car_tree_sha": "<string>",
"predecessor_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pipeline_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merge_commit_sha": "<string>",
"merge_tree_matches": true,
"reason": "<string>",
"reason_text": "<string>",
"detail": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"finished_at": "2023-11-07T05:31:56Z"
}Pipelines
Move a pull request to the front of an application's merge train
Puts a pull request ahead of every car in the merge train that is still queued, building or testing. Cars that already passed or are being merged ahead of it stay ahead. Every car it passes is rebuilt on top of it and its running test is stopped, so only an organisation administrator may move a pull request to the front, and a service account token is refused. An entry already at the front is answered unchanged. Requires pipelines.operate and organisation.manage.
POST
/
api
/
v1
/
org
/
applications
/
{application_id}
/
merge-train
/
entries
/
{entry_id}
/
front
Move a pull request to the front of an application's merge train
import requests
url = "https://platform.ankra.app/api/v1/org/applications/{application_id}/merge-train/entries/{entry_id}/front"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/org/applications/{application_id}/merge-train/entries/{entry_id}/front', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://platform.ankra.app/api/v1/org/applications/{application_id}/merge-train/entries/{entry_id}/front \
--header 'Authorization: Bearer <token>'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pull_request_number": 123,
"pull_request_head_sha": "<string>",
"pull_request_title": "<string>",
"base_branch": "<string>",
"status": "queued",
"position": 123,
"attempt": 123,
"requested_by": "<string>",
"requested_via": "api",
"enqueued_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"car_branch": "<string>",
"car_base_sha": "<string>",
"car_commit_sha": "<string>",
"car_tree_sha": "<string>",
"predecessor_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pipeline_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merge_commit_sha": "<string>",
"merge_tree_matches": true,
"reason": "<string>",
"reason_text": "<string>",
"detail": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"finished_at": "2023-11-07T05:31:56Z"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
The entry, at the front of the cars not yet passed.
The head the train tests and merges; empty until the train first reads the pull request.
Available options:
queued, building, testing, passed, merging, merged, evicted, cancelled Order in the train; lower merges first.
How many cars were built for this pull request.
Available options:
api, comment, portal, tool, label Pattern:
^[a-f0-9]{40}$Pattern:
^[a-f0-9]{40}$Pattern:
^[a-f0-9]{40}$The merge_train run testing the car.
Pattern:
^[a-f0-9]{40}$Whether the merge landed as exactly the tree the car tested.