Home
Version 3
Stacks API

Stacks API

List all Stacks

GET /v2/stacks

Request

Route

GET /v2/stacks

Parameters

Name Description Valid Values Example Values
q Parameters used to filter the result set.
Format queries as <filter><op><value>
Valid ops: : >= <= < > IN
Valid filters: name
  • q=filter:value
  • q=filter>value
  • q=filter IN a,b,c
page Page of results to fetch
results-per-page Number of results per page
order-direction Order of the results: asc (default) or desc
inline-relations-depth 0 - don't inline any relations and return URLs. Otherwise, inline to depth N.
orphan-relations 0 - de-duplicate object entries in response
exclude-relations comma-delimited list of relations to drop from response
include-relations comma-delimited list of the only relations to include in response

Body

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

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTQwNCIsImVtYWlsIjoiZW1haWwtMzAyQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MzIzMTM2Mjh9.ntn1ZG6coXEY2XcUFi9TmHjJ1mZJyL6p7Jv86uYIdF4
Host: example.org
Cookie:

cURL

curl "https://api.[your-domain.com]/v2/stacks" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTQwNCIsImVtYWlsIjoiZW1haWwtMzAyQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MzIzMTM2Mjh9.ntn1ZG6coXEY2XcUFi9TmHjJ1mZJyL6p7Jv86uYIdF4" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Status

200 OK

Body

{
  "total_results": 3,
  "total_pages": 1,
  "prev_url": null,
  "next_url": null,
  "resources": [
    {
      "metadata": {
        "guid": "5e5e28f6-20c8-4303-803c-3218090871e1",
        "url": "/v2/stacks/5e5e28f6-20c8-4303-803c-3218090871e1",
        "created_at": "2015-05-15T16:53:43Z",
        "updated_at": null
      },
      "entity": {
        "name": "lucid64",
        "description": "Ubuntu 10.04 on x86-64"
      }
    },
    {
      "metadata": {
        "guid": "a1b8c6bd-2072-42f6-9691-c520c3f598a6",
        "url": "/v2/stacks/a1b8c6bd-2072-42f6-9691-c520c3f598a6",
        "created_at": "2015-05-15T16:53:43Z",
        "updated_at": null
      },
      "entity": {
        "name": "default-stack-name",
        "description": "default-stack-description"
      }
    },
    {
      "metadata": {
        "guid": "66fd3da0-d245-4737-adc8-f38c7b4f1bd5",
        "url": "/v2/stacks/66fd3da0-d245-4737-adc8-f38c7b4f1bd5",
        "created_at": "2015-05-15T16:53:43Z",
        "updated_at": null
      },
      "entity": {
        "name": "cider",
        "description": "cider-description"
      }
    }
  ]
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 20505f3a-7255-436f-9d56-964ff6c62b96
Content-Length: 1126
X-Content-Type-Options: nosniff