delete_issue_space #

View this page as Markdown

Generated automatically from the published contract sources.

A script calls this action over HTTPS at POST https://turnzero.ai/api/v1/actions/delete_issue_space, with a bearer credential and the action's payload as the JSON body.

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 #

Delete an issue space your account owns, with its issues and its daily copies; nothing restores them. Pass space. This is a destructive action: it needs a signed-in session, or an account-wide token minted with destructive. The call creates a pending action, and the deletion runs only after a person approves it in the browser. The description gives the space's name, its counts, its members, and the applications bound to it; remove issue_tracking.space from each one's manifest before its next deploy. A space you do not own, one shared with you among them, is refused space_not_owned. For 35 days after the deletion, create_issue_space refuses the same identifier.

More about this action #

If a step fails after the approval, the action ends failed, and a new request for the same space finishes the deletion from what remains.

Pass request_id to make a repeat safe. While the earlier pending action is still live (requested, approved, or executing), a call with the same request_id from the same account returns that action and creates no second one. Once the action has completed, failed, been declined, or expired, the same request_id starts a new one.

Access and action metadata #

{
  "name": "delete_issue_space",
  "resource": "account",
  "tier": "destructive",
  "admits": [
    "device_sign_in"
  ],
  "summary": "Delete one issue space of the account's own through the pending action: the space at the issue service, its issues, and its daily copies, with no restore. `space` picks the space. The description gives the space's name, its counts where they can be read, its members with their levels, and the applications bound to it, each of whose next deploy needs its manifest's `issue_tracking.space` removed. Approval ends those bindings, deletes the space and its copies, and ends the space's members, its name, and its token. Only the account that owns the space deletes it: a space the account does not own, one shared with it among them, is refused `space_not_owned`, and an application's own space or the platform's own space `invalid_request`. For 35 days after the deletion, `create_issue_space` refuses the same identifier. `issue_service_unreachable` where the service or the vault could not be read. Registered while the issue service's origin is configured.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "openWorldHint": false
  }
}

MCP catalog entry #

{
  "name": "delete_issue_space",
  "title": "Delete issue space",
  "tier": "destructive",
  "scenario": "API-L0-20",
  "summary": "Delete an issue space your account owns, with its issues and its daily copies; nothing restores them. Pass `space`. This is a destructive action: it needs a signed-in session, or an account-wide token minted with `destructive`. The call creates a pending action, and the deletion runs only after a person approves it in the browser. The description gives the space's name, its counts, its members, and the applications bound to it; remove `issue_tracking.space` from each one's manifest before its next deploy. A space you do not own, one shared with you among them, is refused `space_not_owned`. For 35 days after the deletion, `create_issue_space` refuses the same identifier.",
  "owners": [
    "ITS-L0-01",
    "ITS-L0-06",
    "API-L0-07",
    "MAPI-05",
    "MAPI-18"
  ]
}

request #

JSON pointer Description and constraints
"" (root) Type: object
Required fields: ["space"]
Additional properties: false
/properties/space The space to delete, a lower-case UUID of a space your account owns, as list_issue_spaces lists it with the kind account.

Type: string
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
/properties/request_id Any string you choose. A repeat from the same account while that pending action is live returns it again, creating no second one. Omitted, every call creates a new one.

Type: string

response #

JSON pointer Description and constraints
"" (root) The 202 creation envelope: the pending action and its approval link. Read the terminal outcome on the pending record with read_pending_action. Approval deletes the space at the issue service with its issues and its daily copies, and ends its bindings, its members, its name, and its token. A failed step ends the record failed, its outcome carrying a receipt for each step done beside execution_failed; a new request for the same space finishes the deletion.

Type: object
Required fields: ["contract_version","pending_action","approval_url"]
/properties/contract_version Required value: 1
/properties/reference The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call’s record row. Quote it when you report the call.

Type: string
Pattern: ^[0-9a-f]{10}$
/properties/pending_action $ref: #/shapes/pending_action
/properties/approval_url Type: string
/properties/detail Type: string

Complete payload contract #

{
  "request": {
    "type": "object",
    "required": [
      "space"
    ],
    "properties": {
      "space": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
        "description": "The space to delete, a lower-case UUID of a space your account owns, as `list_issue_spaces` lists it with the kind `account`."
      },
      "request_id": {
        "type": "string",
        "description": "Any string you choose. A repeat from the same account while that pending action is live returns it again, creating no second one. Omitted, every call creates a new one."
      }
    },
    "additionalProperties": false
  },
  "response": {
    "type": "object",
    "description": "The 202 creation envelope: the pending action and its approval link. Read the terminal outcome on the pending record with read_pending_action (API-L0-07). Approval deletes the space at the issue service with its issues and its daily copies, and ends its bindings, its members, its name, and its token (ITS-L0-01; ITS-L0-06). A failed step ends the record `failed`, its outcome carrying a receipt for each step done beside `execution_failed`; a new request for the same space finishes the deletion.",
    "required": [
      "contract_version",
      "pending_action",
      "approval_url"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call’s record row. Quote it when you report the call."
      },
      "pending_action": {
        "$ref": "#/shapes/pending_action"
      },
      "approval_url": {
        "type": "string"
      },
      "detail": {
        "type": "string"
      }
    }
  }
}

Shared contracts #