Updating an App
PATCH /v3/apps/:guid
Request
Route
PATCH /v3/apps/guid-4671f4f4-51f0-421d-8f9b-056afb7cd29b
Parameters
Name |
Description |
Valid Values |
Example Values |
name
|
Name of the App
|
|
|
desired_droplet_guid
|
GUID of the Droplet to be used for the App
|
|
|
Body
Name |
Description |
Default |
Valid Values |
Example Values |
{
"name": "new_name",
"desired_droplet_guid": "guid-d5731159-48bd-425e-b86a-4a8d8e7a3a80"
}
Headers
cURL
curl "https://api.[your-domain.com]/v3/apps/guid-4671f4f4-51f0-421d-8f9b-056afb7cd29b" -d '{
"name": "new_name",
"desired_droplet_guid": "guid-d5731159-48bd-425e-b86a-4a8d8e7a3a80"
}' -X PATCH \
-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM3MSIsImVtYWlsIjoiZW1haWwtMjczQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5yZWFkIiwiY2xvdWRfY29udHJvbGxlci53cml0ZSJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjU5NDg2Nzl9.EXMZGgL_2MnDjwGqTM8DIcuHd72N6MQNVIEG30s4ltk" \
-H "Host: example.org" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Cookie: "
Response
Status
200 OK
Body
{
"guid": "guid-4671f4f4-51f0-421d-8f9b-056afb7cd29b",
"name": "new_name",
"_links": {
"self": {
"href": "/v3/apps/guid-4671f4f4-51f0-421d-8f9b-056afb7cd29b"
},
"processes": {
"href": "/v3/apps/guid-4671f4f4-51f0-421d-8f9b-056afb7cd29b/processes"
},
"packages": {
"href": "/v3/apps/guid-4671f4f4-51f0-421d-8f9b-056afb7cd29b/packages"
},
"space": {
"href": "/v2/spaces/06d28759-5a31-47bf-a35e-1c54ab59ce7b"
},
"desired_droplet": {
"href": "/v3/droplets/guid-d5731159-48bd-425e-b86a-4a8d8e7a3a80"
}
}
}
Headers