Stacks API

Retrieve a Particular Stack

GET /v2/stacks/:guid

Fields

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

Parameters

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

Request

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTQwIiwiZW1haWwiOiJlbWFpbC0zM0Bzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDE3NDYyMzUyfQ.zRn5-k2JZ7pFoHJ7W-VkQzXcP-U7iyake7M6248b37A
Host: example.org
Cookie: 

Route

GET /v2/stacks/d382907a-0fca-476a-b3e0-ef6f2288fbdd

cURL

curl "https://api.[your-domain.com]/v2/stacks/d382907a-0fca-476a-b3e0-ef6f2288fbdd" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTQwIiwiZW1haWwiOiJlbWFpbC0zM0Bzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDE3NDYyMzUyfQ.zRn5-k2JZ7pFoHJ7W-VkQzXcP-U7iyake7M6248b37A" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: d566801c-9eee-43bc-b858-e78dbb383f1c
Content-Length: 293
X-Content-Type-Options: nosniff

Status

200 OK

Body

{
  "metadata": {
    "guid": "d382907a-0fca-476a-b3e0-ef6f2288fbdd",
    "url": "/v2/stacks/d382907a-0fca-476a-b3e0-ef6f2288fbdd",
    "created_at": "2014-11-24T19:32:24+00:00",
    "updated_at": null
  },
  "entity": {
    "name": "lucid64",
    "description": "Ubuntu 10.04 on x86-64"
  }
}