manage_modal_app
Stop a live Modal app or roll back to a previous deployment by app name or ID, specifying the target environment or profile.
Instructions
Change a deployed app's state. Both actions affect live traffic.
Args:
action: "stop" — shut the app down, ending web endpoints (`modal app stop`).
"rollback" — restore a previous deployment (`modal app rollback`).
app_identifier: App name ("my-app") or ID ("ap-...").
version: Rollback target; omit for the immediately preceding version. List valid
versions with list_modal_resources(resource="app_history", name=...).
env: Modal environment to target.
profile: Modal profile for this call only. Defaults to the active profile.
Returns: {message, stdout, stderr} or {error}.
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": {
"action": "<action>",
"app_identifier": "<app_identifier>"
},
"name": "manage_modal_app"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | ||
| action | Yes | ||
| profile | No | ||
| version | No | ||
| app_identifier | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |