Change the position of a Buildpack
PUT /v2/buildpacks/:guid
Buildpacks are maintained in an ordered list. If the target position is already occupied,
the entries will be shifted down the list to make room. If the target position is beyond
the end of the current list, the buildpack will be positioned at the end of the list.
Request
Route
PUT /v2/buildpacks/591bd6c5-2330-4dc1-9400-a405dc659ee9
Parameters
| Name |
Description |
Valid Values |
Example Values |
|
guid
|
The guid of the Buildpack
|
|
|
Body
| Name |
Description |
Default |
Valid Values |
Example Values |
|
name
|
The name of the buildpack. To be used by app buildpack field. (only alphanumeric characters)
|
|
|
|
|
stack
|
The stack the buildpack belongs to.
|
|
|
|
|
position
|
The order in which the buildpacks are checked during buildpack auto-detection.
|
|
|
|
|
enabled
|
Whether or not the buildpack will be used for staging
|
true
|
|
|
|
locked
|
Whether or not the buildpack is locked to prevent updates
|
false
|
|
|
|
filename
|
The name of the uploaded buildpack file
|
|
|
|
{
"position": 3
}
Headers
cURL
curl "https://api.[your-domain.com]/v2/buildpacks/591bd6c5-2330-4dc1-9400-a405dc659ee9" -d '{
"position": 3
}' -X PUT \
-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE3NiIsImVtYWlsIjoiZW1haWwtMTMxQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NjYwMDg4OTF9.CjoftEa2s9Qh96K-G-DZ5ewXTgqDND8fTR6BjpmmxIE" \
-H "Host: example.org" \
-H "Content-Type: application/json" \
-H "Cookie: "
Response
Status
201 Created
Body
{
"metadata": {
"guid": "591bd6c5-2330-4dc1-9400-a405dc659ee9",
"url": "/v2/buildpacks/591bd6c5-2330-4dc1-9400-a405dc659ee9",
"created_at": "2016-06-08T16:41:31Z",
"updated_at": "2016-06-08T16:41:31Z"
},
"entity": {
"name": "name_1",
"stack": "cflinuxfs4",
"position": 3,
"enabled": true,
"locked": false,
"filename": "name-1631"
}
}
Headers