---
title: "revoke_app_sign_in_keys"
description: "Generated reference for the management action revoke_app_sign_in_keys: its description, access metadata, payload contract, and registration status."
slug: /reference/actions/revoke-app-sign-in-keys
order: 63
visibility: public
redirects_from: ["/reference/actions/rotate-realm-keys","/reference/actions/revoke-realm-keys"]
---

# revoke\_app\_sign\_in\_keys

Generated automatically from the [published contract sources](/cloud/reference/about/#contract-sources).

A script calls this action over HTTPS at `POST https://tzcloud.turnzero.ai/v1/revoke_app_sign_in_keys`, with a bearer credential and the action's payload as the JSON body. An MCP connection lists this action as the tool `tzcloud_revoke_app_sign_in_keys`.

OAuth access tokens and minted tokens, including the turnzero command's computer token, are bearer credentials. The action determines which kinds, scopes and grants it accepts ([Sign-in, sessions, and tokens](/cloud/concepts/sign-in-sessions-and-tokens/)).

**Build metadata:** Registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.

## Contract description

Revoke every signing key of one of an application's sign\-in realms, for a suspected key compromise\. Every end\-user session token the keys signed is refused as `key_revoked` on every serving router within sixty seconds\. Every user of the realm signs in again, and the platform creates the replacement key at the realm's next sign\-in\. You must pass `environment`: `development` or `production`, the realm whose keys are revoked\. You get back the revoked key identifiers and the key set's new version\.

## Access and action metadata

```json
{
  "name": "revoke_app_sign_in_keys",
  "resource": "realm",
  "tier": "reversible",
  "surface": "tzcloud",
  "addresses": [
    "tzcloud"
  ],
  "product": "cloud",
  "summary": "Revoke every signing key of one realm: every session token the keys signed is refused as key_revoked once the routers sync, every user signs in again, and the accounts service mints the replacement at the next sign-in.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "openWorldHint": false
  }
}
```

## MCP catalog entry

```json
{
  "name": "revoke_app_sign_in_keys",
  "title": "Revoke app sign-in keys",
  "tier": "reversible",
  "summary": "Revoke every signing key of one of an application's sign-in realms, for a suspected key compromise. Every end-user session token the keys signed is refused as `key_revoked` on every serving router within sixty seconds. Every user of the realm signs in again, and the platform creates the replacement key at the realm's next sign-in. You must pass `environment`: `development` or `production`, the realm whose keys are revoked. You get back the revoked key identifiers and the key set's new version.",
  "owners": [
    "ACS-L0-08",
    "PLD-L0-40"
  ],
  "scenario": "ACS-L0-08"
}
```

## request

| JSON pointer | Description and constraints |
|---|---|
| "" \(root\) | Type: object<br>Required fields: \["application","environment"\]<br>Additional properties: false |
| /<wbr>properties/<wbr>application | Your account's application `id` from `list_applications`, not its name or label\.<br><br>Type: string |
| /<wbr>properties/<wbr>environment | Required\. The environment whose realm's signing keys you revoke, `development` or `production`\.<br><br>Type: string<br>Pattern: ^\(development\|production\)$ |

## response

| JSON pointer | Description and constraints |
|---|---|
| "" \(root\) | Type: object<br>Required fields: \["contract\_version","realm","application","environment","revoked","keys\_changed\_at"\]<br>Additional properties: false |
| /<wbr>properties/<wbr>contract\_version | Required value: 1 |
| /<wbr>properties/<wbr>realm | The realm identifier: the application id for production, `<id>:development` for development\.<br><br>Type: string |
| /<wbr>properties/<wbr>application | Type: string |
| /<wbr>properties/<wbr>environment | Type: string<br>Pattern: ^\(development\|production\)$ |
| /<wbr>properties/<wbr>revoked | The key identifiers stamped revoked by this call; empty where the realm held no live key\.<br><br>Type: array |
| /<wbr>properties/<wbr>revoked/<wbr>items | Type: string |
| /<wbr>properties/<wbr>keys\_changed\_at | The realm key set's version after the call, the value the sync route and the key\-set route return as `version`\.<br><br>Type: \["string","null"\] |
| /<wbr>properties/<wbr>detail | Type: string |

## Complete payload contract

```json
{
  "request": {
    "type": "object",
    "required": [
      "application",
      "environment"
    ],
    "properties": {
      "application": {
        "type": "string",
        "description": "Your account's application `id` from `list_applications`, not its name or label."
      },
      "environment": {
        "type": "string",
        "pattern": "^(development|production)$",
        "description": "Required. The environment whose realm's signing keys you revoke, `development` or `production`."
      }
    },
    "additionalProperties": false
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "realm",
      "application",
      "environment",
      "revoked",
      "keys_changed_at"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "realm": {
        "type": "string",
        "description": "The realm identifier: the application id for production, `<id>:development` for development."
      },
      "application": {
        "type": "string"
      },
      "environment": {
        "type": "string",
        "pattern": "^(development|production)$"
      },
      "revoked": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "The key identifiers stamped revoked by this call; empty where the realm held no live key."
      },
      "keys_changed_at": {
        "type": [
          "string",
          "null"
        ],
        "description": "The realm key set's version after the call, the value the sync route and the key-set route return as `version`."
      },
      "detail": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }
}
```

## Shared contracts

- [Refusals](/cloud/reference/refusals/): every refusal, by surface, with its cause and its remedy
- [schemas/wire\_error\.schema\.json](/cloud/reference/sources/schemas/wire-error-schema/)
- [schemas/wire\_errors\.json](/cloud/reference/sources/schemas/wire-errors/)
- [schemas/action\_payloads\.json](/cloud/reference/sources/schemas/action-payloads/) (includes shared shapes)
- [management\_api\_contract\.md](/cloud/reference/sources/management-api-contract/)
