Addons

Check the latest release of a Marso Studio addon.

Addon endpoints return release data for Marso Studio addons, such as the Blender addon. Use them to check for a new version to install.

Retrieve the latest version of a Marso Studio addon.

get

Returns the latest published version and display name for one Marso Studio addon. An addon build calls this endpoint to check for an update, then prompts its user to download and install the new version.

Authorizations

AuthorizationstringRequired

API key created in the Marso Studio dashboard. The value has the form mxr_live_<entropy> and is sent as a Bearer token in the Authorization header.

Query parameters

addonstring · enumRequired

The Marso Studio addon to look up.

Possible values:

Responses

200

The latest published version of the addon.

application/json

The response body for GET /addons.

versionstringRequired

The latest published version of the addon, for example 2.0.1.

display_namestringRequired

The name to show a user for the addon, for example Marso for Blender.

400

The request is invalid because the addon query parameter is absent or names an addon this API does not support (INVALID_REQUEST).

application/json

401

The API key is missing, invalid, or revoked. Possible error codes: API_KEY_MISSING, API_KEY_INVALID, API_KEY_REVOKED, or UNAUTHORIZED.

application/json

429

Rate limit exceeded (RATE_LIMITED). The response includes a Retry-After header with the number of seconds to wait before retrying, plus the X-RateLimit-* headers. Those headers are also present on successful (2xx) responses so a client can pace itself.

application/json

503

Release information is temporarily unavailable for the requested addon (SERVICE_UNAVAILABLE).

application/json

get/addons

GET /api/public/v1/addons?addon=blender HTTP/1.1
Host: api.marso.app/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "version": "text",
  "display_name": "text"
}