--- title: "delete_issue_space" description: "Generated reference for the management action delete_issue_space: its description, access metadata, payload contract, and registration status." slug: /reference/actions/delete-issue-space order: 114 visibility: public redirects_from: [] --- # delete\_issue\_space Generated automatically from the [published contract sources](/cloud/reference/about/#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 ```json { "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 ```json { "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 ```json { "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 - [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/)