---
search:
  tags:
    - Owner and agent
    - POST
seo:
  description: >-
    Requires action access and a current device grant. Only undispatched…
    Reference for the POST /v1/actions/{actionId}/cancel endpoint in the
    openlaunch API.
sidebar:
  label: Cancel queued action
  badge: POST
title: Cancel queued action
type: openapi-operation
---
Requires action access and a current device grant. Only undispatched queued actions can be cancelled; cancellation cannot undo an action already received by a device.

`POST /v1/actions/{actionId}/cancel`

**ol CLI**

```bash
ol actions cancel "$ACTION_ID"
```

**openlaunch SDK**

```ts
import { createClient } from "@openlaunch/sdk";
const agent = createClient({ url: process.env.OPENLAUNCH_URL ?? "https://www.openlaunch.dev", token: process.env.OPENLAUNCH_AGENT_TOKEN! });
const action = await agent.cancelAction(actionId);
```