Home
Version 3
Processes (Experimental) API

Processes (Experimental) API

Updating a Process

PATCH /v3/processes/:guid

Fields

Name Description Default Valid Values Example Values

Parameters

Name Description Valid Values Example Values
name Name of process
memory Amount of memory (MB) allocated to each instance
instances Number of instances
disk_quota Amount of disk space (MB) allocated to each instance
space_guid Guid of associated Space
stack_guid Guid of associated Stack
state Desired state of process
command Start command for process
buildpack Buildpack used to stage process
health_check_timeout Health check timeout for process
docker_image Name of docker image containing process
environment_json JSON key-value pairs for ENV variables

Request

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTMxMSIsImVtYWlsIjoiZW1haWwtMjM2QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MTY1MjY3MTV9.43zQeT9_QpdcROdtl-V-Z9sbi2IruSpz3DeKhtx1kn0
Host: example.org
Content-Type: application/x-www-form-urlencoded
Cookie: 

Route

PATCH /v3/processes/d17f9b64-2b0c-44ee-89f0-9a0e397cb12f

Body

{
  "name": "new_name",
  "memory": 2555,
  "instances": 2,
  "disk_quota": 2048,
  "space_guid": "0a9ab744-b808-4037-aaee-9bfcfcba0764",
  "stack_guid": "b7352201-1515-4c9d-b9ee-9c86c994d325",
  "command": "X"
}

cURL

curl "https://api.[your-domain.com]/v3/processes/d17f9b64-2b0c-44ee-89f0-9a0e397cb12f" -d '{
  "name": "new_name",
  "memory": 2555,
  "instances": 2,
  "disk_quota": 2048,
  "space_guid": "0a9ab744-b808-4037-aaee-9bfcfcba0764",
  "stack_guid": "b7352201-1515-4c9d-b9ee-9c86c994d325",
  "command": "X"
}' -X PATCH \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTMxMSIsImVtYWlsIjoiZW1haWwtMjM2QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MTY1MjY3MTV9.43zQeT9_QpdcROdtl-V-Z9sbi2IruSpz3DeKhtx1kn0" \
	-H "Host: example.org" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: eff7e804-a816-4a1d-9bf0-8c44ea6083ee
Content-Length: 52
X-Content-Type-Options: nosniff

Status

200 OK

Body

{
  "guid": "d17f9b64-2b0c-44ee-89f0-9a0e397cb12f"
}