---
title: "Cancel a lab instance"
slug: "cancel-a-lab-instance-1"
updated: 2026-01-30T19:22:07Z
published: 2026-01-30T19:22:07Z
canonical: "docs.skillable.com/cancel-a-lab-instance-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a lab instance

Get/cancel

The **Cancel** command allows you to cancel a specified lab instance.

**Please note**: when issuing this command that there is some time required for the lab instance tear down process. If retrying a lab launch for a user where the Max Active Lab Instances Per User is set to 1 for the API consumer, then please take this teardown time into account for the API integration.

SecurityAPI Key: api_keyHeader parameter nameapi_key

All methods require an API key, which must be obtained from Skillable. This key is used by Skillable to validate your account. The key can be passed as an HTTP request header with the header name "api_key".

Query parameterslabinstanceidinteger (int64) Required

The ID of the lab instance to cancel.

Example12345678
notestring

Note that details any additional context for why the lab was canceled.

ExampleCanceled since the lab instance is no longer being used.

Responses200

OK Response

<select class='api-response-data' aria-label='Media type'><option value='e9f34d4f-14d6-465a-bf73-70b81b6a2010'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='f2c80371-2297-4221-859c-1c3ad2682a9e'>Example of successfully cancelling a lab instance avail...</option>
<option value='8b8367c2-3deb-4a49-8cdf-78806ec3da23'>Example of trying to cancel a lab instance launched by ...</option>
</select>Example of successfully cancelling a lab instance available to the API consumer

Example of a successful response

```json
{
  "Result": 1,
  "Error": null,
  "Status": 1
}
```

Example of trying to cancel a lab instance launched by a different API consumer

Example of an error response

```json
{
  "Error": "Invalid integration key",
  "Status": 1
}
```

object  Resultinteger    

Indicates the result of the lab instance cancellation. 0 = Error 1 = Success

Statusinteger    

Indicates the status of the API request. 0 = Error 1 = Success

Errorstring   | null  

In the event of an error, this will contain a detailed error message.