getMarketplaceIcon

GET

/api/v1/plugin-store/{packageId}/artwork/icon

const url = 'https://example.com/api/v1/plugin-store/example/artwork/icon';
const options = {method: 'GET', headers: {cookie: 'tilecast_session=<tilecast_session>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/v1/plugin-store/example/artwork/icon \
  --cookie tilecast_session=<tilecast_session>

The icon of a store entry. For an included plugin the image is a release-owned file the server reads from its own binary and serves directly, as PNG or WebP. For a marketplace listing it is served from the server’s verified artwork cache. The request names a package, never an address. The server fetches only the listing’s declared HTTPS address with bounded size, time, and redirects, refuses non-public addresses, and serves PNG, JPEG, GIF, or WebP only. Any failure answers artwork_unavailable.

Authorizations

sessionCookie
userBearer

Parameters

Path Parameters

packageId

required

string

/^[a-z][a-z0-9_.:-]{0,127}$/

Store package identifier such as countdown_bar.

Responses

200

Icon image

string format: binary

304

The cached image is unchanged

401

Dashboard authentication required

404

Artwork_unavailable — the entry has no such artwork or the server could not fetch it