---
title: "Returns instructions for a specific lab"
slug: "returns-instructions-for-a-specific-lab-1"
updated: 2025-08-07T14:39:28Z
published: 2025-08-07T14:41:42Z
---

> ## 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.

# Returns instructions for a specific lab

Get/GetLabInstructions

The **GetLabInstructions** command allows you to download the IDLx instructions of a lab as a string.

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 parametersidinteger (int32) Required

The ID of the lab profile that will be the source of the instructions. The profile must be owned by the organization on the API consumer.

Example2393048
langstring

Allows you to select the language of the Instruction Set. Using this in connection with **instructionsId** will allow you to select a specific lab Instruction Set in the specified language if they have been defined within the lab profile.

NOTE: If this parameter is omitted, or if the specified language is not specified on one of the Instruction sets in a lab profile, then the default language as defined in the **Lab Profile ➔ Manage Instructions Sets** option will be used instead.

en = English es = Spanish fr = French de = German pt = Portuguese ja = Japanese zh-hans = Simplified Chinese zh-hant = Traditional Chinese ko = Korean

Valid values[
  "en",
  "es",
  "fr",
  "de",
  "pt",
  "ja",
  "zh-hans",
  "zh-hant",
  "ko"
]Exampleen
instructionsIdstring

When specified, Skillable will attempt to retrieve the selected instructions. If not specified, or the instruction Id could not be found, the default instructions, as defined on the Lab Profile, will be used instead. This is a string that cannot contain spaces.

NOTE: To be able to see how to use this parameter, add the column "**API Example**" in the **Manage Instruction Sets** feature while editing the instructions.

ExampleBase-01

Responses200

OK Response.

<select class='api-response-data' aria-label='Media type'><option value='555caef1-ea84-4d2a-81bd-c13b96cd7a38'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='2a324132-08d2-46ec-9cf2-9d52a1c86961'>Example of retrieving the instructions from a lab</option>
<option value='f766840d-4fb6-4efe-8362-c13f2157a8d5'>Example when trying to retrieve instructions for a none...</option>
</select>Example of retrieving the instructions from a lab

```json
{
  "Instructions": "##Welcome to the world of tomorrow!",
  "Error": null,
  "Status": 1
}
```

Example when trying to retrieve instructions for a nonexistent lab profile

```json
{
  "Error": "Lab profile not found",
  "Status": 0
}
```

object  Instructionsstring   | null  

The IDLx instructions of a lab.

Errorstring   | null  

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

Statusinteger  (int32)    

0 = Error 1 = Success