---
title: "PUT /api/engine/containers"
method: PUT
path: "/api/engine/containers"
tags: ["netbox containers"]
---

# PUT /api/engine/containers

`PUT /api/engine/containers`

## Request body

- PutApiEngineContainers
  - `data` object
    - `id` number
    - `hostname` string
    - `name` string
    - `ContainerID` string
    - `restart_policy` 'no' | 'on-failure' | 'always' | 'unless-stopped'
    - `extra_hosts` string[]
    - `operation` 'restart' | 'start' | 'stop' | 'recreate' | 'rename' | 'kill' | 'pause' | 'unpause' | 'none'
    - `image` string
    - `labels` object
    - `env` string[]
    - `ports` object
    - `networks` object
    - `mounts` object[]
      - `type` string
      - `source` string
      - `destination` string
      - `mode` string
      - `rw` boolean
      - `name` string
      - `driver` string

## Response `202`

202 response

## Changes

> 16 revisions in range; 1 could not be searched.

- **2024-11-22** `4a0ba5258468` — 2 info
  - added the new optional request property `data/extra_hosts`
  - added the new optional request property `data/restart_policy`
- **2024-05-08** `8b2274e5097e` — 1 info
  - added the new optional request property `data/ContainerID`
- **2024-05-08** `4ad360d07081` — 4 info
  - added the new `kill` enum value to the request property `data/operation`
  - added the new `pause` enum value to the request property `data/operation`
  - added the new `rename` enum value to the request property `data/operation`
  - added the new `unpause` enum value to the request property `data/operation`
- **2024-04-19** `1d84e5d69a75` — 1 info
  - added the new `none` enum value to the request property `data/operation`
- **2024-02-15** `391707b34e1c` — 5 breaking, 3 warning
  - removed the enum value `kill` of the request property `data/operation`
  - removed the enum value `none` of the request property `data/operation`
  - removed the enum value `pause` of the request property `data/operation`
  - removed the enum value `rename` of the request property `data/operation`
  - …4 more

[Change history](https://skmtc.dev/saashup/apis/netbox-docker-agent/changes/api/engine/containers/put.md)

---

[API](https://skmtc.dev/saashup/apis/netbox-docker-agent.md) · [All operations](https://skmtc.dev/saashup/apis/netbox-docker-agent/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saashup/netbox-docker-agent/revisions/a704a83fd7f8/schema)