remove_standby_installation

Stop keeping the standby installation (the spare bot) registered for a project.

Purpose

The standby is forgotten and withdrawn from the connector; the live installation, members and access stay as they are, and the next bot replacement will need a fresh credential pasted on the dashboard. Registering a standby is not offered to tokens because it takes a credential; removing one is. Only the project owner may do this.

This tool is annotated destructive: a client that supports the annotation asks a human before running it. The REST twin is DELETE /v1/projects/{project}/recovery/standby-installation.

Required ability

project-recovery:delete

Input schema

{
    "type": "object",
    "required": [
        "project_id"
    ],
    "properties": {
        "project_id": {
            "type": "string",
            "description": "UUID of the project whose standby installation to remove."
        }
    }
}

Output shape

{
    "data": {
        "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
        "standby_installation_registered": false
    },
    "meta": {}
}

Example prompts

"Drop the standby bot on Research Premium; I am replacing it with a new one from the dashboard."

Failure modes

  • VALIDATION_FAILED — the token is not the project owner's.
  • RESOURCE_NOT_FOUNDproject_id is not a project the token can see.
  • AUTHENTICATION_REQUIRED — no authenticated user on the request.
  • TOKEN_MISSING_ABILITY — token lacks project-recovery:delete.

How is this guide?

On this page

Subscriby is a product designed by you — for you.

No boardroom full of executives deciding what we ships next. Our roadmap always shaped by you with your feedback.

Share feedback or a request