metabuilder/docs/api/packages.md

Packages API

Package installation and seed data management via HTTP endpoints.

Installed Packages

GET /api/packages/installed

Returns all installed packages.

Response:

{
  "installed": [
    {
      "packageId": "social_forum",
      "installedAt": 1735140000000,
      "version": "1.2.0",
      "enabled": true
    }
  ]
}

POST /api/packages/installed

Installs a package by ID using the server-side catalog and seeds.

Request:

{
  "packageId": "social_forum"
}

Response:

{
  "installed": {
    "packageId": "social_forum",
    "installedAt": 1735140000000,
    "version": "1.2.0",
    "enabled": true
  }
}

PATCH /api/packages/installed/{packageId}

Updates enabled state for an installed package.

Request:

{
  "enabled": false
}

DELETE /api/packages/installed/{packageId}

Uninstalls a package and removes its seeded data.

Response:

{
  "deleted": true
}

Package Data

GET /api/packages/data/{packageId}

Returns stored seed data for a package.

Response:

{
  "data": {
    "users": [{ "id": "user_1" }]
  }
}

PUT /api/packages/data/{packageId}

Replaces stored seed data for a package.

Request:

{
  "data": {
    "users": [{ "id": "user_1" }]
  }
}

DELETE /api/packages/data/{packageId}

Deletes stored seed data for a package.

Response:

{
  "deleted": true
}