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
      }
    }
  ]
}