{
 "documentation_revision": 10,
 "api_revision": 58,
 "source": "Endpoints.all + Learn.endpoints + McpTools",
 "operation": {
  "summary": "Propose an exact owner change; it executes only after this agent has the separate owner.configuration grant AND the owner approves it on the phone",
  "method": "POST",
  "auth": true,
  "mcp_tool": "owner_configure",
  "query": [],
  "developer_only": false,
  "capture": false,
  "body": [
   {
    "name": "action",
    "description": "Action from GET /v1/owner/features",
    "type": "string",
    "required": true,
    "enum": [
     "resource.download",
     "resource.delete",
     "resource.check",
     "dog.configure",
     "dog.start",
     "dog.stop",
     "dog.find_camera",
     "dog.clear_history",
     "tour.start",
     "wake.configure",
     "sounds.configure",
     "remote.configure",
     "callback.configure",
     "delivery.subscribe",
     "updates.offers",
     "updates.install",
     "android.setup"
    ]
   },
   {
    "name": "options",
    "description": "Exact action options from GET /v1/owner/features; unknown fields and all credential fields refused",
    "type": "object",
    "required": true
   }
  ],
  "example": "POST /v1/owner/configure {\"action\":\"resource.download\",\"options\":{\"resource\":\"wake-english\"}}",
  "idempotent": true,
  "path": "/v1/owner/configure",
  "capability": "owner_features",
  "returns": "durable v2 operation: awaiting_owner/completed/failed; inspect /v2/operations/{id} or MCP bridgit_operation_get; resource operations return a resource job id after approval",
  "mcp_input_schema": {
   "type": "object",
   "properties": {
    "options": {
     "description": "Exact action options from GET /v1/owner/features; unknown fields and all credential fields refused",
     "type": "object"
    },
    "action": {
     "description": "Action from GET /v1/owner/features",
     "type": "string",
     "enum": [
      "resource.download",
      "resource.delete",
      "resource.check",
      "dog.configure",
      "dog.start",
      "dog.stop",
      "dog.find_camera",
      "dog.clear_history",
      "tour.start",
      "wake.configure",
      "sounds.configure",
      "remote.configure",
      "callback.configure",
      "delivery.subscribe",
      "updates.offers",
      "updates.install",
      "android.setup"
     ]
    },
    "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"
    }
   },
   "required": [
    "action",
    "options",
    "idempotency_key"
   ]
  },
  "errors": [
   "invalid_parameter",
   "agent_not_allowed",
   "forbidden"
  ],
  "requires": null
 }
}