Apps (Experimental) API

Get an App

GET /v3/apps/:guid

Request

Route

GET /v3/apps/guid-7051028d-1877-4653-8590-4c2fbcceea11

Body

Name	Description	Default	Valid Values	Example Values

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTI4NSIsImVtYWlsIjoiZW1haWwtMjE3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5yZWFkIiwiY2xvdWRfY29udHJvbGxlci53cml0ZSJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0Mjc0ODA4NjR9.RhyB5sPwm8PBAQPRE_OJmGQxNAFzwLCx7DLo8PT73mo
Host: example.org
Cookie: 

cURL

curl "https://api.[your-domain.com]/v3/apps/guid-7051028d-1877-4653-8590-4c2fbcceea11" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTI4NSIsImVtYWlsIjoiZW1haWwtMjE3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5yZWFkIiwiY2xvdWRfY29udHJvbGxlci53cml0ZSJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0Mjc0ODA4NjR9.RhyB5sPwm8PBAQPRE_OJmGQxNAFzwLCx7DLo8PT73mo" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Status

200 OK

Body

{
  "guid": "guid-7051028d-1877-4653-8590-4c2fbcceea11",
  "name": "my_app",
  "desired_state": "STOPPED",
  "_links": {
    "self": {
      "href": "/v3/apps/guid-7051028d-1877-4653-8590-4c2fbcceea11"
    },
    "processes": {
      "href": "/v3/apps/guid-7051028d-1877-4653-8590-4c2fbcceea11/processes"
    },
    "packages": {
      "href": "/v3/apps/guid-7051028d-1877-4653-8590-4c2fbcceea11/packages"
    },
    "space": {
      "href": "/v2/spaces/fd537274-1ca0-468d-8c1c-ad7239013554"
    },
    "desired_droplet": {
      "href": "/v3/droplets/a-droplet-guid"
    }
  }
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 0bae99c6-867c-403c-ba2c-b416246d105c
Content-Length: 579
X-Content-Type-Options: nosniff