GET /v1/diff/{from}/{to} — Ad-hoc version diff

The /v1/diff/{from}/{to} endpoint returns an item-level diff between any two version directories the server still retains. It first looks for a precomputed diff-from-{from}.json inside the to version directory; if there isn’t one, it computes the diff on demand. Use this endpoint when you need a diff that isn’t simply “the latest” — for example, replaying a sequence of patches against an older cache or comparing a specific historical pair.

Endpoint

GET https://astra.teamfortuna.xyz/v1/diff/{from}/{to}

Path parameters

string

required

Manifest ID of the older version. Must match ^[A-Za-z0-9._-]+$, be 1–128 characters, and must not start with a dot or equal current (those names are reserved for pipeline internals).

string

required

Manifest ID of the newer version. Same validation rules as from.

Request

The User-Agent header is required for all requests to the Astra API. Use the format AppName/Version (+URL).

curl https://astra.teamfortuna.xyz/v1/diff/VAL_12.06/VAL_12.07 \
  -H "User-Agent: MyApp/1.0 (+https://example.com)"

Response fields

number

HTTP status code of the response (e.g. 200).

object

Hide properties

string

Manifest ID of the from version.

string

Manifest ID of the to version.

string

ISO 8601 timestamp of when the diff was generated. For precomputed diffs, this is the pipeline run time; for on-demand diffs, it is the request time.

object

Map of category name (agents, weapons, etc.) to a category diff with added, removed, and changed arrays. added and removed contain UUIDs; changed contains objects with the uuid and the sorted list of top-level fields whose serialized value differs.

object

Show properties

number

Total number of added items across all categories.

number

Total number of removed items across all categories.

number

Total number of changed items across all categories.

Response

{
  "status": 200,
  "data": {
    "fromVersion": "VAL_12.06",
    "toVersion": "VAL_12.07",
    "generatedAt": "2026-04-22T14:25:22.602Z",
    "categories": {
      "agents": {
        "added": [],
        "removed": [],
        "changed": [
          {
            "uuid": "8e9aa2e9-0e34-4d59-b2b3-9a8a7b6c5d4e",
            "fields": ["abilities"]
          }
        ]
      }
    },
    "summary": {
      "totalAdded": 0,
      "totalRemoved": 0,
      "totalChanged": 1
    }
  }
}

Errors

status

Returned when either from or to is empty, longer than 128 characters, contains characters outside [A-Za-z0-9._-], equals ./.., starts with a dot, or equals current.

status

Returned when either version directory does not exist on disk. Older versions are pruned by retention.

status

Returned when a precomputed diff file exists but is unreadable or corrupt.

When the same diff is requested repeatedly, prefer the precomputed path: ask for the exact from/to pair the pipeline already wrote (each version dir has a single diff-from-{prev}.json). On-demand diffs are computed per request and are more expensive.

⌘I

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

GET /v1/diff/{from}/{to} — Ad-hoc version diff

Endpoint

Path parameters

Request

Response fields

Response

Errors

​Endpoint

​Path parameters

​Request

​Response fields

​Response

​Errors

Endpoint

Path parameters

Request

Response fields

Response

Errors