`POST /images`

Experimental. Pulls a registry image and converts it to a bootable rootfs. Returns 501 when image support is not enabled (set --image-dir).

### Authorizations

- `bearerAuth` — HTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

### Request body

`application/json`

- `ref` string · optional

### Responses

**201** — Created

`application/json`:

- `cmd` array of string · optional
- `content_bytes` integer (int64) · optional
- `convert_mode` string · optional
- `converted_at_unix_ms` integer (int64) · optional
- `digest` string · optional
- `entries` integer · optional
- `entrypoint` array of string · optional
- `exposed_ports` array of string · optional
- `size_bytes` integer (int64) · optional
- `source_ref` string · optional

**400** — Bad Request

`application/json`:

- `error` string · optional

**501** — Not Implemented

`application/json`:

- `error` string · optional

**502** — Bad Gateway

`application/json`:

- `error` string · optional