---
title: "Launches the runtime environment described by the provided manifest in an asynchronous manner"
method: PUT
path: "/launch/async"
tags: ["launch"]
---

# Launches the runtime environment described by the provided manifest in an asynchronous manner

`PUT /launch/async`

## Query parameters

- `impersonate` string
- `dispatchId` string

## Request body

- Manifest — Describes the capsule to be launched
  - `manifestVersion` string, required
  - `clientMetadata` ClientMetadata, required
    - `name` string, required
    - `title` string
    - `description` string
    - `additionalProperties` object
  - `warehouseMetadata` WarehouseMetadata
    - `owner` string
    - `created` string
    - `modified` string
    - `version` string
    - `tags` string[]
    - `server` string
    - `additionalProperties` object
  - `dispatchMetadata` DispatchMetadata
    - `owner` string
    - `dispatcher` string
    - `carriers` object
    - `launched` string
    - `terminated` string
    - `userInterfaces` UserInterface[]
      - `type` string
      - `location` string
      - `additionalProperties` object
    - `additionalProperties` object
  - `payloads` Payload[]
    - `name` string
    - `id` string
    - `version` string
    - `carriers` string[]
    - `launchParameters` LaunchParameters
      - `mode` string
      - `environment` object
      - `configuration` object
      - `data` Data[]
        - `name` string
        - `type` string
        - `source` string
        - `target` string
        - `readOnly` boolean
        - `mountLocations` string[]
        - `additionalProperties` object
      - `images` object
      - `dependencies` string[]
      - `arguments` string[]
      - `custom` object
      - `additionalProperties` object
    - `resourceRequirements` ResourceRequirements
      - `instances` object
      - `cores` object
      - `memory` object
      - `gpus` object
      - `scratch` object
      - `additionalProperties` object
    - `additionalProperties` object
  - `sharedData` Data[]
    - `name` string
    - `type` string
    - `source` string
    - `target` string
    - `readOnly` boolean
    - `mountLocations` string[]
    - `additionalProperties` object
  - `additionalProperties` object

## Response `202`

Runtime environment was accepted for launch

- DispatchInfo
  - `launchedCapsuleReference` OwnedResourceReference
    - `owner` string
    - `name` string
    - `version` string
  - `launchingUser` string
  - `dispatchId` string
  - `state` 'UNKNOWN' | 'PENDING' | 'RUNNING' | 'TERMINATING' | 'MISSING' | 'TERMINATED' | 'COMPLETED' | 'FAILED'
  - `events` Event[]
    - `level` 'TRACE' | 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR'
    - `timestamp` string
    - `reporter` string
    - `message` string
    - `extraInfo` object
    - `additionalProperties` object
  - `lastUpdated` string
  - `payloadStates` object
  - `additionalProperties` object

## Other responses

- `400` — Invalid environment manifest
- `403` — User does not have permission to launch environments as the specified impersonation user
- `500` — Runtime environment couldn't be launched

---

[API](https://skmtc.net/determined-ai/apis/launcher-api.md) · [All operations](https://skmtc.net/determined-ai/apis/launcher-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/determined-ai/launcher-api/versions/33885ccfb9ac/schema)