List the key-value cache items belonging to an app

GET /apps/{app-slug}/cache-items

List all the available cache items that the builds of the app created via the save-cache step.

Path parameters

  • app-slug string Required

    App slug

Query parameters

  • next string

    Getting cache items created before the given parameter (RFC3339 time format, default: now)

  • limit integer

    Max number of elements per page (default: 100)

Responses

  • 200

    OK

    Hide response attributes Show response attributes object
    • data array[object]
      Hide data attributes Show data attributes object
      • app_id string
      • archive_filename string
      • archive_size integer
      • cache_key string
      • created_at string
      • expires_at string
      • id string
      • last_used_at string
    • paging object

      Additional properties are allowed.

      Hide paging attributes Show paging attributes object
      • next string

        Next is the "anchor" for pagination. This value should be passed to the same endpoint to get the next page. Empty/not included if there's no "next" page. Stop paging when there's no "Next" item in the response!

      • page_item_limit integer

        PageItemLimit - per-page item count. A given page might include less items if there's not enough items. This value is the "max item count per page".

      • total_item_count integer

        TotalItemCount - total item count, through "all pages"

  • 400

    Bad Request

    Hide response attribute Show response attribute object
    • message string
  • 401

    Unauthorized

    Hide response attribute Show response attribute object
    • message string
  • 404

    Not Found

    Hide response attribute Show response attribute object
    • message string
  • 500

    Internal Server Error

    Hide response attribute Show response attribute object
    • message string
GET /apps/{app-slug}/cache-items
curl \
 --request GET 'https://api.bitrise.io/v0.1/apps/{app-slug}/cache-items' \
 --header "Authorization: $API_KEY"
Response examples (200)
{
  "data": [
    {
      "app_id": "string",
      "archive_filename": "string",
      "archive_size": 42,
      "cache_key": "string",
      "created_at": "string",
      "expires_at": "string",
      "id": "string",
      "last_used_at": "string"
    }
  ],
  "paging": {
    "next": "string",
    "page_item_limit": 42,
    "total_item_count": 42
  }
}
Response examples (400)
{
  "message": "string"
}
Response examples (401)
{
  "message": "string"
}
Response examples (404)
{
  "message": "string"
}
Response examples (500)
{
  "message": "string"
}