# CreateImageRequest


[API catalog](/reference/api/) · [Docker Sandboxes overview](/reference/api/sandboxes/latest/) · [Product manual](https://docs.docker.com/ai/sandboxes-api/) · [OpenAPI specification](/reference/api/sandboxes/api.yaml)

API version: v1


> This API is experimental. Features, interfaces,
> and behavior may change.




Schema constraints and annotations:

```json
{
  "allOf": [
    {
      "properties": {
        "description": {
          "description": "description is caller-supplied text.",
          "type": "string"
        },
        "displayName": {
          "description": "display_name is a scoped label; the backend assigns the immutable resource ID.",
          "minLength": 1,
          "not": {
            "enum": [
              ".",
              ".."
            ],
            "type": "string"
          },
          "pattern": "^[^/]+$",
          "type": "string"
        },
        "readyCmd": {
          "description": "ready_cmd is used to determine readiness for raw image sandboxes.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "startCmd": {
          "description": "start_cmd is used when the image is launched as a raw image sandbox.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      }
    },
    {
      "oneOf": [
        {
          "properties": {
            "fromImage": {
              "$ref": "#/components/schemas/ImageFromImage",
              "description": "from_image registers an entry that will receive pushed OCI content."
            }
          },
          "required": [
            "fromImage"
          ],
          "title": "from_image",
          "type": "object"
        }
      ]
    }
  ],
  "description": "CreateImageRequest creates a managed image.",
  "required": [
    "displayName"
  ],
  "title": "CreateImageRequest",
  "type": "object",
  "unevaluatedProperties": false
}
```