{
 "documentation_revision": 27,
 "api_revision": 73,
 "source": "Endpoints.all + Learn.endpoints + McpTools",
 "operation": {
  "summary": "Change an installed applet to a new revision of the same package (new version). It is recompiled and swapped in at once when it needs no new permission (unchanged watches keep their history); otherwise it waits for the owner's approval like an install",
  "method": "POST",
  "auth": true,
  "mcp_tool": "applets_installed_update",
  "query": [],
  "developer_only": false,
  "capture": false,
  "body": [
   {
    "name": "package",
    "description": "The applet file itself: a bridgit-template/1 definition with runtime.adapter android.package.v1 (see https://bridgit.cc/learn/builder/applet-packages.md)",
    "type": "object",
    "required": false
   },
   {
    "name": "url",
    "description": "Instead of package: an https://bridgit.cc/\u2026 package file (for example a recipe's applet.json)",
    "type": "string",
    "required": false
   },
   {
    "name": "template",
    "description": "Instead of package: a template registry key (with revision)",
    "type": "string",
    "required": false
   },
   {
    "name": "revision",
    "description": "With template: the immutable revision",
    "type": "integer",
    "required": false
   },
   {
    "name": "config",
    "description": "Values for the applet's blanks (config_schema); the rest use defaults. The owner can still change them on the review screen",
    "type": "object",
    "required": false
   }
  ],
  "example": "POST /v1/applets/installed/ai0123456789abcd/update {\"package\":{\u2026version 1.1.0\u2026},\"config\":{\"interval_s\":120}}",
  "idempotent": true,
  "path": "/v1/applets/installed/{id}/update",
  "capability": "applet_install",
  "returns": "status updated (with instance) or awaiting_owner (with added_permissions)",
  "mcp_input_schema": {
   "type": "object",
   "properties": {
    "template": {
     "description": "Instead of package: a template registry key (with revision)",
     "type": "string"
    },
    "package": {
     "description": "The applet file itself: a bridgit-template/1 definition with runtime.adapter android.package.v1 (see https://bridgit.cc/learn/builder/applet-packages.md)",
     "type": "object"
    },
    "idempotency_key": {
     "description": "Any UUID; repeating the call with the same key within 24 h returns the first result instead of acting twice",
     "type": "string"
    },
    "id": {
     "description": "The id in /v1/applets/installed/{id}/update",
     "type": "string"
    },
    "config": {
     "description": "Values for the applet's blanks (config_schema); the rest use defaults. The owner can still change them on the review screen",
     "type": "object"
    },
    "url": {
     "description": "Instead of package: an https://bridgit.cc/\u2026 package file (for example a recipe's applet.json)",
     "type": "string"
    },
    "revision": {
     "description": "With template: the immutable revision",
     "type": "integer"
    }
   },
   "required": ["id"]
  },
  "errors": [
   "not_found",
   "invalid_parameter",
   "capability_disabled"
  ],
  "requires": null
 }
}