Revoke Port Access Key
revoke_access_keyRevoke a pod port's access key to invalidate its value immediately; use confirm=false to preview and confirm=true to apply, since revocation cannot be undone.
Instructions
Revoke one access key of a pod's port so that its value stops working. It can't be undone; a new key has a new value.
With confirm=false (default) it only returns which key would be revoked and changes nothing; call again with confirm=true and the summary's pod_name after the user agreed.
The value stops working within seconds, and so does an older value that still worked after a roll. Programs that send it then get 401. A connection that is already open, such as a WebSocket, stays open until it closes.
Only a workspace admin or billing member can revoke keys. To replace a key's value without an outage, use roll_access_key instead.
Every write requires operation_id. Reuse the ID returned by the preview, or generate a UUID before the first call. Keep it for confirmation and all retries; a new ID means a new operation. After a timeout, check operation_status and resource state before retrying.
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": {
"pod": "<pod>",
"port": "<port>",
"key_id": "<key_id>"
},
"name": "revoke_access_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pod | Yes | The pod_name from the pods tool. Its display name also works, except on a confirmed call (confirm=true) that opens a port, changes a key or signs out browsers: use the `pod_name` the preview returned. | |
| port | Yes | The port number, from the pod's `endpoints` in the pods tool; it must be exposed over HTTPS (`access` locked or unlocked). | |
| key_id | Yes | The key's `id` from the access_keys tool. | |
| confirm | No | ||
| workspace | No | ||
| operation_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||