List Power_outlets
netbox_list_power_outletsList power outlets from NetBox with filter and pagination support to browse or narrow down results by device, name, type, or phase leg.
Instructions
List PDU power outlets from NetBox.
Supports pagination and filtering. Common patterns:
Discovery: call with no filters to browse the first power_outlets.
Lookup by id: use netbox_get_power_outlet instead when you already have an id.
Narrow scan: combine 'q' (fuzzy text) with resource-specific filters below.
Pagination:
'limit' (max 1000, default 50) and 'offset'. Response includes 'has_more' and 'next_offset'.
Large list responses auto-truncate to keep under the character limit; keep calling with next_offset to continue.
Resource-specific filters:
device_id: Numeric device id.
device: Device name.
name: Exact outlet name.
name__ic: Outlet name contains (case-insensitive).
type: Power outlet type slug.
power_port_id: Filter by parent power port id.
feed_leg: Phase leg: A, B, or C.
Universal filters:
q (string) Fuzzy text search across searchable fields.
tag (string[]) AND-filter by tag slugs.
created_after (date) ISO-8601 lower bound on 'created'.
created_before (date) ISO-8601 upper bound on 'created'.
Returns: Markdown summary (default) or JSON with shape: { total, count, offset, limit, items: [...], has_more, next_offset? }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Fuzzy full-text search across the object's searchable fields (name, description, etc.). | |
| tag | No | Filter to objects that have ALL of these tag slugs. Repeat for multiple tags (AND semantics in NetBox). | |
| name | No | Exact outlet name. | |
| type | No | Power outlet type slug. | |
| limit | No | Maximum number of items to return per page (1-1000, default 50). | |
| device | No | Device name. | |
| offset | No | Number of items to skip for pagination. Use next_offset from a previous response. | |
| feed_leg | No | Phase leg: A, B, or C. | |
| name__ic | No | Outlet name contains (case-insensitive). | |
| device_id | No | Numeric device id. | |
| created_after | No | ISO-8601 date; only return objects created on or after this date (e.g. 2024-01-01). | |
| power_port_id | No | Filter by parent power port id. | |
| created_before | No | ISO-8601 date; only return objects created on or before this date. | |
| response_format | No | Output format: 'markdown' (default, human-readable) or 'json' (full structured payload). Use 'json' when chaining follow-up tool calls. | markdown |