---
title: "Launch instances"
method: POST
path: "/instance-operations/launch"
---

# Launch instances

`POST /instance-operations/launch`

Launches one or more instances of a given instance type.

## Request body

- object
  - `region_name` string, required — Short name of a region
  - `instance_type_name` string, required — Name of an instance type
  - `ssh_key_names` SshKeyName[], required — Names of the SSH keys to allow access to the instances. Currently, exactly one SSH key must be specified.
  - `file_system_names` FileSystemName[] — Names of the file systems to attach to the instances. Currently, only one (if any) file system may be specified.
  - `quantity` integer — Number of instances to launch
  - `name` string, nullable — User-provided name for the instance

## Response `200`

OK

- object
  - `data` object, required
    - `instance_ids` InstanceId[], required — The unique identifiers (IDs) of the launched instances. Note: if a quantity was specified, fewer than the requested quantity might have been launched.

## Other responses

- `400` — Request parameters were invalid.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Object does not exist.
- `500` — Something unexpected occurred.

---

[API](https://skmtc.dev/unweave/apis/lambda-cloud-api.md) · [All operations](https://skmtc.dev/unweave/apis/lambda-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unweave/lambda-cloud-api/revisions/fd68e04e7a08/schema)