# update_user_preferences

Replace or clear the authorized user's confirmed Meetly preference profile in private iCloud.

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| profile | object | Yes | User-approved preference notes only; up to 64 forward-compatible fields and 8192 UTF-8 JSON bytes. Field names start with a lowercase letter and contain only letters, digits, dot, underscore or hyphen. Intended for preference notes, not secrets, transcripts, host memory or unrelated documents. Schedule notes are preferences, not a scheduler. |
| expected_revision | integer | Yes | No description supplied by the catalog. Minimum: 0. Maximum: 9007199254740990. |
| request_id | string | Yes | No description supplied by the catalog. |

## What you get

- **revision:** revision returned by this tool.
- **replayed:** replayed returned by this tool.

## Full description

Replace or clear the authorized user's confirmed Meetly preference profile in private iCloud. Requires preferences read/write consent, the expected profile revision and an idempotency request ID. Accepts up to 64 bounded string fields. Returns the resulting revision; retries with the same request ID and payload are idempotent.

Write-capable · Potentially destructive · Server 0.17.0

Source commit: 6cc62bc5b29fb3bf09648dc755c8f5a26ea54d18

## Tool definition

```json
{
  "name": "update_user_preferences",
  "title": "Save confirmed Meetly preferences",
  "description": "Replace or clear the authorized user's confirmed Meetly preference profile in private iCloud. Requires preferences read/write consent, the expected profile revision and an idempotency request ID. Accepts up to 64 bounded string fields. Returns the resulting revision; retries with the same request ID and payload are idempotent.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "openWorldHint": false,
    "idempotentHint": true,
    "title": "Save confirmed Meetly preferences"
  },
  "securitySchemes": [
    {
      "type": "oauth2",
      "scopes": [
        "meetings:read",
        "preferences:read",
        "preferences:write"
      ]
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "oauth2",
        "scopes": [
          "meetings:read",
          "preferences:read",
          "preferences:write"
        ]
      }
    ]
  },
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "profile": {
        "type": "object",
        "maxProperties": 64,
        "propertyNames": {
          "pattern": "^[a-z][A-Za-z0-9._-]{0,63}$"
        },
        "additionalProperties": {
          "type": "string",
          "maxLength": 2000
        },
        "description": "User-approved preference notes only; up to 64 forward-compatible fields and 8192 UTF-8 JSON bytes. Field names start with a lowercase letter and contain only letters, digits, dot, underscore or hyphen. Intended for preference notes, not secrets, transcripts, host memory or unrelated documents. Schedule notes are preferences, not a scheduler."
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740990
      },
      "request_id": {
        "type": "string",
        "format": "uuid"
      }
    },
    "required": [
      "profile",
      "expected_revision",
      "request_id"
    ]
  },
  "outputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "revision": {
        "type": "integer",
        "minimum": 1
      },
      "replayed": {
        "type": "boolean"
      }
    },
    "required": [
      "revision",
      "replayed"
    ]
  }
}
```

[All tools](/tools/)
