# app.image.pull

Pull a docker image.

This method is a job.

Type: object

##

Type: array
No Additional Items

#### Tuple Validation

##### Parameter 1: image_pull

#### image_pull

Type: object

AppImagePullArgs parameters.

No Additional Properties

##

Default: null

Authentication configuration for private registries or `null` for public images.

## Any of

#### AppImageAuthConfig

Type: object
No Additional Properties

##

#### Username

Type: string

Username for container registry authentication.

##

#### Password

Type: string

Password or access token for container registry authentication.

##

#### Registry Uri

Default: null

Container registry URI or `null` to use default registry.

## Any of

Type: string
Type: null
Type: null

##

#### Image

Type: string

Container image reference to pull (registry/repository:tag).

Must be at least `1` characters long

##

#### Result

Type: null

Returns `null` when the image is successfully pulled.

Required roles: APPS_WRITE