> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spirii.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a TENANT sub-network

> Deletes a sub-network. Only sub-networks can be deleted — base networks are permanent. If the sub-network is still assigned to token groups, the deletion is blocked as a safety measure; set `force=true` to remove the assignments and delete anyway.



## OpenAPI

````yaml /openapi/emsp-network/openapi.yaml delete /emsp/v1/networks/{network_id}
openapi: 3.0.0
info:
  title: Spirii EMSP - Network & Access Control API
  description: >-
    Manages network access and location visibility for secure multi-tenant
    operation.
  version: v1
  contact: {}
servers:
  - url: https://api.spirii.com
    description: Production
security:
  - OAuth2ClientCredentials: []
tags:
  - name: Networks
    description: Network lifecycle management
paths:
  /emsp/v1/networks/{network_id}:
    delete:
      tags:
        - Networks
      summary: Delete a TENANT sub-network
      description: >-
        Deletes a sub-network. Only sub-networks can be deleted — base networks
        are permanent. If the sub-network is still assigned to token groups, the
        deletion is blocked as a safety measure; set `force=true` to remove the
        assignments and delete anyway.
      operationId: NetworkController_remove_v1
      parameters:
        - name: Idempotency-Key
          in: header
          description: >-
            Client-generated unique key per operation intent (UUID). Same key +
            identical body replays the original response; same key + different
            body returns 409.
          required: true
          schema:
            type: string
            format: uuid
        - name: network_id
          required: true
          in: path
          description: The unique ID of the sub-network to delete.
          schema:
            type: string
            format: uuid
        - name: force
          required: false
          in: query
          description: >-
            Remove any Token Group assignments before deleting instead of
            returning 409
          schema:
            default: false
            type: boolean
      responses:
        '204':
          description: The sub-network was deleted. Fires network.deleted webhook.
        '409':
          description: Token Group assignments exist and force=false
components:
  securitySchemes:
    OAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          scopes:
            emsp:networks:read: View network and access control configuration
            emsp:networks:write: Create/update/delete SUB networks, manage access rules
            emsp:networks:publish: Publish/drain networks (PATCH /networks/:id/publish-state)

````