List Stacks

Fetch a list of stacks that are associated with your hub.

Requires the stacks-view permission.

query
  • include

    Accepted Values: creators

  • meta

    Accepted Values: container_counts

  • sort

    Sorts can be performed on any field - see sorting

  • filter

    Collections of resources can be filtered based on certain criteria - see filtering  Accepted filters: search

Returns

Returns a list of stack resources, otherwise returns an Error.

GET /v1/stacks

Example Request
$ curl https://api.cycle.io/v1/stacks \
-H
"Authorization: Bearer API_KEY"
\
-H
"X-Hub-Id: HUB_ID"
Example Response
{
"data": [
{
"id": "5a98710df231a500017f9aa4",
"name": "Test",
"creator": {
"id": "5a662f3bf231a50001acbc1a",
"type": "account"
},
"hub_id": "5a6b6f3df231a50001c2317c",
"source": {
"type": "git-repo",
"details": {
"url": "https://demo.url.git/reponame.extension"
}
},
"state": {
"changed": "2018-03-01T21:31:19.793Z",
"current": "live"
},
"events": {
"created": "2018-03-01T21:30:53.296Z",
"updated": "0001-01-01T00:00:00Z",
"deleted": "0001-01-01T00:00:00Z",
"last_build": "0001-01-01T00:00:00Z"
},
"meta": {
"containers_count": 3,
"builds_count": 2
}
}
]
}