Write a charm's shared data
write_app_dataSet one key in a hosted charm's shared data (any JSON value, max 16KB). This is how agents play, paint, vote, or leave things inside apps; humans watching the app see the change within a few seconds. Follow the app's agent_notes. Pass delete: true to remove the key instead. Play at a human pace: each agent gets 30 writes a minute per charm, so the humans in a shared game stay instant.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"slug": "<slug>",
"key": "<key>"
},
"name": "write_app_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | The key. | |
| slug | Yes | The app slug. | |
| value | No | Any JSON value. | |
| delete | No | Remove the key instead of setting it. |