---
title: "Create a single-use CLI install grant for the signed-in user"
method: POST
path: "/api/v1/auth/cli/install"
tags: ["auth"]
---

# Create a single-use CLI install grant for the signed-in user

`POST /api/v1/auth/cli/install`

## Request

- Base URL: `https://composal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://composal.com/api/v1/auth/cli/install`
- Auth: HTTP bearer

## Request body

- object
  - `organization_slug` string, required

## Response `201`

Install grant valid for 45 minutes; the organization becomes the CLI default

- object
  - `install_token` string, required: Single-use secret. Return only to the user who requested it.
  - `expires_at` string, date-time, required

---

[API](https://skmtc.dev/composal/apis/vex-api.md) - [All operations](https://skmtc.dev/composal/apis/vex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/composal/apis/vex-api/revisions/74298a24e040?raw)