---
title: "Create a new virtual interface for a tenant"
method: POST
path: "/tenant/{tenant_name}/virtual_interface"
tags: ["tenant - virtual interface"]
---

# Create a new virtual interface for a tenant

`POST /tenant/{tenant_name}/virtual_interface`

## Path parameters

- `tenant_name` unknown, required

## Request body

- NBVirtualInterfaceTenantCreateRequest
  - `name` string, required
  - `virtual_interface_type` 'bridged' | 'routed' | 'loopback'
  - `ipv4_addresses` string[]
  - `ipv6_addresses` string[]
  - `description` string, nullable
  - `mtu` integer
  - `administrative_state` 'up' | 'down'
  - `network_segments` string[]
  - `labels` object
  - `system_name` string, nullable

## Response `201`

Successful Response

- NBRequestResponse
  - `id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `status` 'received' | 'in_progress' | 'success' | 'failed' | 'cancelled', required
  - `extra_details` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/zayo/apis/niro-api.md) · [All operations](https://skmtc.net/zayo/apis/niro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zayo/niro-api/revisions/c52ac26e1766/schema)