# Unregister a Runner

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

Unregistration rejects new calls, cleans up associated native sessions, revokes tokens, and deletes ownership and records. Success does not mean the user's host process stopped or all disk files were deleted. Errors may follow entry into deleting, which ordinary lists/details hide. Retain original IDs and request information for recovery checks.


```http
DELETE https://api.moi.matrixorigin.cn/v5/agent-runners/{id}
```

## Before you call this API

Set `BASE_URL` to the product API prefix `https://api.moi.matrixorigin.cn/v5`. For private deployments, use the corresponding product API URL.

[Prepare identity and identifiers](objects.md#prepare).

## Request

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

```bash
curl --request DELETE \
  "$BASE_URL/agent-runners/$RUNNER_ID" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"
```

:::::
:::::{tab-item} Parameters

| Parameter | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Workspace-ID` | Headers | string | Yes | Target Workspace in the same environment; there is no Workspace path segment. |
| `id` | Path | string | Yes | Accessible Runner ID in the same Workspace, obtained from creation or lists. |

:::::
::::::
:::::::

## Successful response

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {}
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `code` | string | OK on success. |
| `msg` | string | Response information; OK on success. |
| `data` | object | [Response objects and omission conditions](objects.md#responses). |

:::::
::::::
:::::::

## Error responses

[Errors and recovery boundaries](lifecycle.md#errors) distinguishes Runner, Edge renewal, and compute observations. They do not share one numeric error table.
