Home
Version 3
Stacks API

Stacks API

Retrieve a Particular Stack

GET /v2/stacks/:guid

Request

Route

GET /v2/stacks/3c404d45-ac94-4d6d-8260-19d1aa53c2a6

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.eyJ1c2VyX2lkIjoidWFhLWlkLTM3MyIsImVtYWlsIjoiZW1haWwtMjc1QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjYxODc3NjV9.wgU6KpW87K1df_0awtY5-1QWQOBm0WW1dHoT62TwV_o
Host: example.org
Cookie: 

cURL

curl "https://api.[your-domain.com]/v2/stacks/3c404d45-ac94-4d6d-8260-19d1aa53c2a6" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM3MyIsImVtYWlsIjoiZW1haWwtMjc1QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjYxODc3NjV9.wgU6KpW87K1df_0awtY5-1QWQOBm0WW1dHoT62TwV_o" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Status

200 OK

Body

{
  "metadata": {
    "guid": "3c404d45-ac94-4d6d-8260-19d1aa53c2a6",
    "url": "/v2/stacks/3c404d45-ac94-4d6d-8260-19d1aa53c2a6",
    "created_at": "2015-03-05T19:15:53Z",
    "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: 00c2a37c-c5c2-486d-a693-c3a0ca5f95f4
Content-Length: 288
X-Content-Type-Options: nosniff