Stacks API

Retrieve a Particular Stack

GET /v2/stacks/:guid

Request

Route

GET /v2/stacks/fcf47da3-43d3-4033-b328-cfe5573a529c

Parameters

Name	Description	Valid Values	Example Values
guid	The guid of the Stack

Body

Name	Description	Default	Valid Values	Example Values
name	The name for the stack.
description	The description for the stack

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM0MSIsImVtYWlsIjoiZW1haWwtMjQzQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjU5NDg2NzZ9.SnjuHo9PUE9IDwtdZGNUPrNMsCPFq5ManUdDUKoi7fs
Host: example.org
Cookie: 

cURL

curl "https://api.[your-domain.com]/v2/stacks/fcf47da3-43d3-4033-b328-cfe5573a529c" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM0MSIsImVtYWlsIjoiZW1haWwtMjQzQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjU5NDg2NzZ9.SnjuHo9PUE9IDwtdZGNUPrNMsCPFq5ManUdDUKoi7fs" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Status

200 OK

Body

{
  "metadata": {
    "guid": "fcf47da3-43d3-4033-b328-cfe5573a529c",
    "url": "/v2/stacks/fcf47da3-43d3-4033-b328-cfe5573a529c",
    "created_at": "2015-03-03T00:51:04Z",
    "updated_at": null
  },
  "entity": {
    "name": "lucid64",
    "description": "Ubuntu 10.04 on x86-64"
  }
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 69e520c9-9ce3-4cf5-bfd7-e8d33bd5783c
Content-Length: 288
X-Content-Type-Options: nosniff