---
title: "Temporary credentials: the connection view with a lease per engine that expires (an hour unless ttl_minutes says otherwise)"
method: POST
path: "/instances/{instance_id}/access"
tags: ["access"]
---

# Temporary credentials: the connection view with a lease per engine that expires (an hour unless ttl_minutes says otherwise)

`POST /instances/{instance_id}/access`

## Request

- Base URL: `https://app.lathe.live/api/v1`
- URL: `https://app.lathe.live/api/v1/instances/{instance_id}/access`
- Auth: none declared

## Path parameters

- `instance_id` string, required

## Request body

- AccessIn
  - `engines` string[], nullable: Which engines to lease; omit for every engine on the box that takes one.
  - `ttl_minutes` integer, nullable: How long the credentials work, 5 to 720 minutes; 60 when omitted. The auth engine's key: at most 60.

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lathe/apis/lathe-customer-api.md) · [All operations](https://skmtc.dev/lathe/apis/lathe-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lathe/apis/lathe-customer-api/revisions/68cfd9bb71c1?raw)