Inspect Container

Get Container Details

GET /api/containers/{id}?env=1

Retrieves detailed information about a specific container, including its configuration, state, and network settings.

Path Parameters

string

required

The container ID or name

Query Parameters

string

required

The environment ID where the container is located

Response

Returns a detailed container inspection object from the Docker API.

string

Full container ID

string

Container name (includes leading slash)

string

ISO 8601 timestamp of when the container was created

string

Command executable being run

array

Command arguments

object

Container state information

string

Current status (e.g., “running”, “exited”, “paused”)

boolean

Whether the container is running

boolean

Whether the container is paused

boolean

Whether the container is restarting

number

Exit code if the container has stopped

string

ISO 8601 timestamp of when the container started

string

ISO 8601 timestamp of when the container finished

string

Image ID

object

Container configuration

string

Container hostname

array

Environment variables as strings in “KEY=value” format

array

Command to run

string

Image name and tag

object

Container labels

object

Network configuration

string

Primary IP address

object

Port mappings

object

Network attachments

array

Volume mounts and bind mounts

Error Responses

string

Error message if the request fails

Status Codes:

200 - Success
403 - Permission denied
500 - Failed to inspect container

Example

curl -X GET "https://your-dockhand.com/api/containers/abc123def456?env=1" \
  -H "Cookie: session=your-session-cookie"

const containerId = 'abc123def456';
const response = await fetch(`/api/containers/${containerId}?env=1`, {
  method: 'GET',
  credentials: 'include'
});

const details = await response.json();
console.log(details);

Response Example

{
  "Id": "abc123def456789...",
  "Name": "/my-nginx",
  "Created": "2024-01-15T10:30:00.000Z",
  "State": {
    "Status": "running",
    "Running": true,
    "Paused": false,
    "Restarting": false,
    "ExitCode": 0,
    "StartedAt": "2024-01-15T10:30:01.000Z"
  },
  "Image": "sha256:abc123...",
  "Config": {
    "Hostname": "abc123def456",
    "Env": [
      "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
      "NGINX_VERSION=1.25.3"
    ],
    "Image": "nginx:latest",
    "Labels": {}
  },
  "NetworkSettings": {
    "IPAddress": "172.17.0.2",
    "Ports": {
      "80/tcp": [
        {
          "HostIp": "0.0.0.0",
          "HostPort": "8080"
        }
      ]
    }
  }
}