---
title: "Freeze the device state as a world (the device is stopped while the world is taken and stays stopped)"
method: POST
path: "/devices/{name}/worlds"
tags: ["Snapshots and worlds"]
---

# Freeze the device state as a world (the device is stopped while the world is taken and stays stopped)

`POST /devices/{name}/worlds`

## Request

- Base URL: `https://api.clousd.com/v1`
- URL: `https://api.clousd.com/v1/devices/{name}/worlds`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required

## Response `202`

Started

- object
  - `ok` boolean
  - `job` Job
    - `id` string
    - `kind` string
    - `phone` string
    - `state` 'running' | 'done' | 'failed'
    - `started` string, date-time
    - `done` string, date-time
    - `output` string

## Other responses

- `400`: Error

---

[API](https://skmtc.dev/clousd/apis/clousd-api.md) · [All operations](https://skmtc.dev/clousd/apis/clousd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clousd/apis/clousd-api/revisions/0291ffd26ae3?raw)