Logistic Hubs - Dcycle Platform Docs

Early Access - The Dcycle CLI is currently available for enterprise customers. Contact us to learn more about access.

Overview

The hub command manages logistic hubs — distribution centers and logistic nodes used in transport emission calculations.

dcy hub <subcommand> [flags]

Available Commands

Command	Description
`list`	List logistic hubs
`show`	Show hub details
`create`	Create a logistic hub
`edit`	Edit a logistic hub
`delete`	Delete a logistic hub

List Hubs

dcy hub list [flags]

# Aliases
dcy hub ls

Examples

# List all hubs
dcy hub list

# Filter by name and type
dcy hub list --name "Madrid" --type owned

# Filter by category
dcy hub list --category warehouse_ambient

# Filter by facility
dcy hub list --facility <facility-id>

# Filter by status
dcy hub list --status active

# Pagination
dcy hub list --page 2 --size 100

# JSON output
dcy hub list --format json | jq '.[] | {id, name, type, category}'

Flags

Flag	Short	Default	Description
`--name`	`-n`	—	Filter by name
`--type`	`-t`	—	Filter by type (`owned`, `subcontracted`)
`--category`	`-c`	—	Filter by category (see table below)
`--facility`	`-f`	—	Filter by facility ID
`--status`	—	—	Filter by status
`--page`	—	`1`	Page number
`--size`	—	`50`	Items per page
`--org`	—	—	Organization ID override

Hub Categories

transshipment_ambient, transshipment_mixed, storage_transhipment_ambient, storage_transhipment_mixed, warehouse_ambient, warehouse_mixed, liquid_bulk_terminals_ambient, liquid_bulk_terminals_mixed, maritime_container_terminals_ambient, maritime_container_terminals_temperature_controlled

Output

Showing 3 of 3 hubs in Acme Corp
h1-abc123-... | Madrid DC     | owned          | warehouse_ambient | ES | supercharger=false | active
h2-def456-... | Barcelona Hub | subcontracted  | transshipment_ambient | ES | supercharger=true  | active
h3-ghi789-... | Valencia Port | owned          | maritime_container_terminals_ambient | ES | supercharger=false | active

Columns: ID, name, type, category, country, supercharger status, status.

Show Hub Details

dcy hub show <hub-id>

Examples

dcy hub show 00000000-0000-0000-0000-000000000000

# JSON output
dcy hub show <hub-id> --format json

Flags

Flag	Description
`--org`	Organization ID override

Output

ID: h1-abc123-...
Name: Madrid DC
Address: Pol. Ind. Las Mercedes, Madrid
Type: owned
Category: warehouse_ambient
Country: ES
Facility ID: abc123-def456-...
Status: active
Supercharger: false
CO2e: 0.00000 tCO2e

Create Hub

dcy hub create [flags]

Examples

dcy hub create \
  --name "Madrid Distribution Center" \
  --address "Pol. Ind. Las Mercedes, Madrid" \
  --type owned \
  --category warehouse_ambient

dcy hub create \
  --name "Port Terminal" \
  --address "Valencia Port" \
  --type subcontracted \
  --category maritime_container_terminals_ambient \
  --country ES \
  --facility <facility-id>

Flags

Flag	Short	Required	Default	Description
`--name`	`-n`	Yes	—	Hub name
`--address`	`-a`	Yes	—	Physical address
`--type`	`-t`	Yes	—	Hub type (`owned`, `subcontracted`)
`--category`	`-c`	Yes	—	Hub category (see categories above)
`--country`	—	No	—	Country code
`--facility`	—	No	—	Associated facility ID
`--supercharger`	—	No	`false`	Has supercharger (electric charging)
`--org`	—	No	—	Organization ID override

Edit Hub

dcy hub edit <hub-id> [flags]

Examples

dcy hub edit <hub-id> --name "New Name"
dcy hub edit <hub-id> --address "New Address" --supercharger
dcy hub edit <hub-id> --no-supercharger
dcy hub edit <hub-id> --type subcontracted --category transshipment_ambient

Flags

Accepts the same flags as create (all optional). Additionally:

Flag	Description
`--no-supercharger`	Set supercharger to false

Delete Hub

dcy hub delete <hub-id> [flags]

# Aliases
dcy hub rm <hub-id>

Examples

# Interactive confirmation
dcy hub delete <hub-id>

# Skip confirmation
dcy hub delete <hub-id> --yes

Flags

Flag	Short	Default	Description
`--yes`	`-y`	`false`	Skip confirmation prompt
`--org`	—	—	Organization ID override

Output

Confirmation prompt:

Delete hub Madrid DC (h1-abc123-...)? [y/N]

hub deleted successfully: Madrid DC

Common Options

All hub commands support:

Flag	Description
`--format json`	JSON output (default: `text`)
`--verbose`	Show HTTP request/response details
`--timeout`	Request timeout in seconds

Workflows

Export Hubs for Reporting

# Export all hubs as JSON
dcy hub list --format json --size 100 > hubs.json

# Group hubs by type
dcy hub list --format json | jq 'group_by(.type) | map({type: .[0].type, count: length})'

# Find hubs with supercharger
dcy hub list --format json | jq '[.[] | select(.supercharger == true)]'

Piping with jq

# List hub IDs for scripting
dcy hub list --format json | jq -r '.[].id'

# Get hub names and categories
dcy hub list --format json | jq '.[] | {name, type, category}'

​Overview

​Available Commands

​List Hubs

​Examples

​Flags

​Hub Categories

​Output

​Show Hub Details

​Examples

​Flags

​Output

​Create Hub

​Examples

​Flags

​Edit Hub

​Examples

​Flags

​Delete Hub

​Examples

​Flags

​Output

​Common Options

​Workflows

​Export Hubs for Reporting

​Piping with jq

Overview

Available Commands

List Hubs

Examples

Flags

Hub Categories

Output

Show Hub Details

Examples

Flags

Output

Create Hub

Examples

Flags

Edit Hub

Examples

Flags

Delete Hub

Examples

Flags

Output

Common Options

Workflows

Export Hubs for Reporting

Piping with jq