---
title: "Acquire universe"
method: POST
path: "/universes/{universe_id}"
tags: ["Universe"]
---

# Acquire universe

`POST /universes/{universe_id}`

## Request

- Base URL: `https://api.klavis.ai`
- URL: `https://api.klavis.ai/universes/{universe_id}`
- Auth: HTTP bearer

Acquire the next idle universe instance.

## Path parameters

- `universe_id` string, required

## Response `200`

Successful Response

- UniverseInstance: Universe instance details
  - `instance_id` string, required: Unique universe instance ID
  - `mcp_servers` object, required: MCP server connections

## Other responses

- `422`: Validation Error

## Changes

- **2026-02-08** `d70b82139caa`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/klavis-ai/apis/klavis-ai-https-www-klavis-ai/changes/universes/:universe_id/post.md)

---

[API](https://skmtc.dev/klavis-ai/apis/klavis-ai-https-www-klavis-ai.md) - [All operations](https://skmtc.dev/klavis-ai/apis/klavis-ai-https-www-klavis-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/klavis-ai/apis/klavis-ai-https-www-klavis-ai/revisions/1f05ced7280f?raw)