post_org_self_delete_by_orgid_by_requestid_cancel
Calls POST /api/org-self-delete/{orgId}/{requestId}/cancel as the signed-in person · REST reference
Withdraw a deletion request
The person who made it, the organization's owner, or platform staff (403 for anyone else). A request awaiting its code or its parent can be withdrawn; its code stops working.
Arguments
| Argument | Type | Description | |
|---|---|---|---|
orgIdpath | string (uuid) | required | |
requestIdpath | string (uuid) | required | |
bodyJSON | object | The request body, as a JSON object. Its fields are listed below. |
Fields of body
| Field | Type | Description | |
|---|---|---|---|
reason | string |
Example call
A client sends this over the MCP session; Claude and other agents build it for you. The values are placeholders — the shape is real.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "post_org_self_delete_by_orgid_by_requestid_cancel",
"arguments": {
"orgId": "11111111-1111-4111-8111-111111111111",
"requestId": "11111111-1111-4111-8111-111111111111",
"body": {
"reason": "string"
}
}
}
}Result
On success (HTTP 200) the tool returns one text item holding the API's JSON, pretty-printed.
Withdrawn.
{
"data": {
"createdAt": 1,
"expiresAt": 1,
"id": "11111111-1111-4111-8111-111111111111",
"orgId": "11111111-1111-4111-8111-111111111111",
"orgName": "string",
"requestedBy": {
"email": "string",
"userId": "11111111-1111-4111-8111-111111111111",
"firstName": "string",
"lastName": "string"
},
"status": "AWAITING_CODE",
"cancelledAt": 1,
"completedAt": 1,
"confirmedAt": 1,
"decidedAt": 1,
"parentOrgId": "11111111-1111-4111-8111-111111111111",
"parentOrgName": "string",
"reason": "string"
},
"success": true
}Fields
| Field | Type | Description |
|---|---|---|
data | object | |
data.cancelledAt | integer | null | |
data.completedAt | integer | null | |
data.confirmedAt | integer | null | |
data.createdAt | integer | Epoch milliseconds. |
data.decidedAt | integer | null | |
data.expiresAt | integer | Epoch milliseconds — the current step's deadline: the code's (OTP_EXPIRY_SECONDS), then seven days for the parent. |
data.id | string (uuid) | |
data.orgId | string (uuid) | |
data.orgName | string | |
data.parentOrgId | string (uuid) | null | The parent organization that must approve; null when there is none. |
data.parentOrgName | string | null | |
data.reason | string | null | Why it was cancelled or declined. |
data.requestedBy | object | |
data.requestedBy.email | string | |
data.requestedBy.firstName | string | null | |
data.requestedBy.lastName | string | null | |
data.requestedBy.userId | string (uuid) | |
data.status | "AWAITING_CODE" | "AWAITING_PARENT" | "COMPLETED" | "CANCELLED" | "DECLINED" | "EXPIRED" | AWAITING_CODE until the owner enters the emailed code; AWAITING_PARENT while a child organization waits for its parent; COMPLETED once deleted. CANCELLED and DECLINED carry reason. EXPIRED when the current step's deadline passed. |
success | true |
When it fails
A failed call returns isError: true with the API's message as text. A change the person declines, or lets time out, also comes back this way and nothing changes.
400The request was malformed or failed a guard.
403Authenticated, but the caller holds none of the required permissions.
404No request with that id for this organization.
409The resource is not in a state that allows this operation.
What the model is shown
This is the tool exactly as the server lists it in tools/list. The description starts with the REST call it makes.
{
"name": "post_org_self_delete_by_orgid_by_requestid_cancel",
"description": "POST /api/org-self-delete/{orgId}/{requestId}/cancel — The person who made it, the organization's owner, or platform staff (403 for anyone else). A request awaiting its code or its parent can be withdrawn; its code stops working.\n\nThis changes data. The person is asked to confirm it before it runs, and nothing happens if they decline.",
"inputSchema": {
"type": "object",
"properties": {
"orgId": {
"type": "string"
},
"requestId": {
"type": "string"
},
"body": {
"type": "string",
"description": "The JSON request body: { reason: string }"
}
},
"required": [
"orgId",
"requestId"
]
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false
}
}