/app/versions

Manage app versions and features in the Backstack dashboard. Use this endpoint to get and update account versions.

Get app versions

GET /app/versions

# To exclude the feature matrix:
GET /app/versions?exclude_matrix=true

Provides available versions for the current app and account. It includes a matrix property with a list of features and their availability for each version.

Response

{
  "success": true,
  "message": "",
  "payload": {
    "versions": [
      {
        "id": "ver_1234567890",
        "title": "Basic",
        "description": "Core features",
        "more_info": null,
        "active": true,
        "fee": null,
        "user_fee": null,
        "tag": "v1"
      },
      ...
    ],
    "matrix": {
      "versions": [
        "Basic",
        "Advanced",
        "Enterprise"
      ],
      "features": [
        {
          "id": "analytics",
          "title": "Analytics",
          "description": "Track user behavior and app performance.",
          "versions": {
            "ver_1234567890": true,
            "ver_1234567891": true,
            "ver_1234567892": true
          }
        },
        {
          "id": "calendar-integration",
          "title": "Calendar Integration",
          "description": "Integrates with calendar services to manage events and schedules.",
          "versions": {
            "ver_1234567890": false,
            "ver_1234567891": true,
            "ver_1234567892": true
          }
        },
        ...
      ]
    },
    "optional_features_available": true
  }
}

Example version pricing

Use the versions property to create pricing header:

TODO: Change to realistic example

Example feature matrix

Use the matrix properties to create a feature matrix table:

TODO: Highlight this example. (Blends in with the page.)

The optional_features_available property indicates whether optional features are available for the current app version and account. Use this value to provide a link to your optional features page:

if (optional_features_available) {
    // Show optional features link
}

Update app version

Post the new version_id to the API to update the app version for the current account.

POST /app/versions
{
    "version_id": "ver_1234567893"
}

Returns the version history information.

{
  "success": true,
  "message": "Version updated.",
  "payload": {
    "history_id": "avh_1234567892",
    "version_id": "ver_1234567893",
    "timestamp": 1737771170
  }
}

Related information

• Account versions - Version history for the current account.
• App optional features - Optional features for the current app version and account.