refreshMarketplaceCatalog

POST

/api/v1/plugin-store/marketplace/refresh

curl --request POST \
  --url https://example.com/api/v1/plugin-store/marketplace/refresh \
  --cookie tilecast_session=<tilecast_session>

Refresh the official Tilecast marketplace now and answer with its cache status. Requires the Owner or Administrator role with the admin scope. The previous cache keeps serving when the refresh fails.

Authorizations

• sessionCookie
• userBearer

Parameters

Header Parameters

X-CSRF-Token

string

Cookie-backed browser requests only, and only on unsafe methods. Bearer grants never send it.

Responses

200

Marketplace cache status

Media typeapplication/json

object

data

required

object

marketplace

required

The cached catalog behind marketplace entries. Fetch failures keep serving the last valid cache and record the error here.

object

lastFetchedAt

string format: date-time

stale

required

boolean

error

string

Example^generated

{
  "data": {
    "marketplace": {
      "lastFetchedAt": "2026-04-15T12:00:00Z",
      "stale": true,
      "error": "example"
    }
  }
}

401

Dashboard authentication required

403

Owner or Administrator role required

502

Marketplace_refresh_failed — the catalog fetch failed