---
title: "POST /2025-09-09/microvms/{microvmIdentifier}/shell-auth-token"
method: POST
path: "/2025-09-09/microvms/{microvmIdentifier}/shell-auth-token"
---

# POST /2025-09-09/microvms/{microvmIdentifier}/shell-auth-token

`POST /2025-09-09/microvms/{microvmIdentifier}/shell-auth-token`

Creates a shell authentication token for interactive shell access to a running MicroVM. The MicroVM must have been run with the SHELL_INGRESS network connector attached.

## Path parameters

- `microvmIdentifier` string, required — The ARN or ID of the MicroVm

## Request body

- object
  - `expirationInMinutes` integer, required — The duration in minutes before the shell authentication token expires.

## Response `200`

Success

- CreateMicrovmShellAuthTokenResponse
  - `authToken` object, required — The generated shell authentication token key-value pairs for accessing the MicroVM.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — ValidationException

---

[API](https://skmtc.net/aws/apis/lambda-microvms.md) · [All operations](https://skmtc.net/aws/apis/lambda-microvms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lambda-microvms/versions/83f10af82eb8/schema)