Home
Version 3
Stacks API

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.eyJ1c2VyX2lkIjoidWFhLWlkLTI2OCIsImVtYWlsIjoiZW1haWwtMjA4QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjIzMjM1NTB9.Ww8A1GwAEdTcJ1X4MOrCpgosPa5k1HHdk-Bh0KgoMgg
Host: example.org
Cookie: 

Route

GET /v2/stacks/e6fffa49-4b82-4e85-a11f-36bc8cdab6a5

cURL

curl "https://api.[your-domain.com]/v2/stacks/e6fffa49-4b82-4e85-a11f-36bc8cdab6a5" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTI2OCIsImVtYWlsIjoiZW1haWwtMjA4QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjIzMjM1NTB9.Ww8A1GwAEdTcJ1X4MOrCpgosPa5k1HHdk-Bh0KgoMgg" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 3a17e1e8-2efa-4af0-aba5-f3de198a2eae
Content-Length: 293
X-Content-Type-Options: nosniff

Status

200 OK

Body

{
  "metadata": {
    "guid": "e6fffa49-4b82-4e85-a11f-36bc8cdab6a5",
    "url": "/v2/stacks/e6fffa49-4b82-4e85-a11f-36bc8cdab6a5",
    "created_at": "2015-01-20T01:52:15+00:00",
    "updated_at": null
  },
  "entity": {
    "name": "lucid64",
    "description": "Ubuntu 10.04 on x86-64"
  }
}