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

# Unpublish Super Node

> Unpublish a workflow version as a super node.

If version_number is omitted, resolves to the workflow's active_version_number.
Sets is_active=False on the SuperNodesModel document for that (workflow, version) pair.
The workflow itself is not modified. Also warns about any workflows in this team that
currently embed this super node — those will fail at execution time once the interface
snapshot they hold diverges or becomes stale.

When dry_run=true, the SuperNodesModel document is left untouched and only the list of
referencing workflows is returned. This lets the dashboard show a confirmation prompt
before performing the destructive call.



## OpenAPI

````yaml https://api-prod.interactly.ai/api-docs/workflows/api.json delete /workflows/v1/workflows/{workflow_id}/super-node-interface
openapi: 3.1.0
info:
  title: Interactly API
  description: API for building interactly.ai services
  version: 1.1.0
  contact:
    name: Interactly
    url: https://interactly.ai
    email: developers@interactly.ai
servers:
  - url: https://api-prod.interactly.ai
    description: API Server
security: []
paths:
  /workflows/v1/workflows/{workflow_id}/super-node-interface:
    delete:
      tags:
        - Super Nodes
      summary: Unpublish Super Node
      description: >-
        Unpublish a workflow version as a super node.


        If version_number is omitted, resolves to the workflow's
        active_version_number.

        Sets is_active=False on the SuperNodesModel document for that (workflow,
        version) pair.

        The workflow itself is not modified. Also warns about any workflows in
        this team that

        currently embed this super node — those will fail at execution time once
        the interface

        snapshot they hold diverges or becomes stale.


        When dry_run=true, the SuperNodesModel document is left untouched and
        only the list of

        referencing workflows is returned. This lets the dashboard show a
        confirmation prompt

        before performing the destructive call.
      operationId: >-
        workflow_service_unpublish_super_node_v1_workflows__workflow_id__super_node_interface_delete
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PydanticObjectId'
        - name: version_number
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            title: Version Number
        - name: dry_run
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              When true, do not actually unpublish — only return the list of
              workflows that currently reference this super node. Used by the UI
              to surface a confirmation dialog.
            default: false
            title: Dry Run
          description: >-
            When true, do not actually unpublish — only return the list of
            workflows that currently reference this super node. Used by the UI
            to surface a confirmation dialog.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnpublishSuperNodeResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - bearer: []
components:
  schemas:
    PydanticObjectId:
      type: string
      maxLength: 24
      minLength: 24
      pattern: ^[0-9a-f]{24}$
      example: 5eb7cf5a86d9755df3a6c593
    UnpublishSuperNodeResponse:
      properties:
        workflow_id:
          type: string
          title: Workflow Id
        workflow_version_number:
          anyOf:
            - type: integer
            - type: 'null'
          title: Workflow Version Number
          description: Version number that was unpublished
        message:
          type: string
          title: Message
        dry_run:
          type: boolean
          title: Dry Run
          description: >-
            When true, the super node was NOT actually unpublished; the response
            only previews which workflows reference it. Used by the UI to show a
            confirmation dialog before a real DELETE.
          default: false
        workflows_referencing:
          items:
            type: string
          type: array
          title: Workflows Referencing
          description: >-
            IDs of other workflows that currently embed this super node. They
            will break at execution time. May be truncated — see
            ``workflows_referencing_total`` and
            ``workflows_referencing_truncated``.
        workflows_referencing_total:
          type: integer
          title: Workflows Referencing Total
          description: Total number of dependent workflows, regardless of truncation.
          default: 0
        workflows_referencing_truncated:
          type: boolean
          title: Workflows Referencing Truncated
          description: >-
            True when ``workflows_referencing`` was capped and additional
            dependents exist beyond the returned list. Use the dedicated
            dependents endpoint to page through them.
          default: false
      type: object
      required:
        - workflow_id
        - message
      title: UnpublishSuperNodeResponse
      description: Response after unpublishing a super node.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: Bearer
      type: http
      description: >-
        Retrieve your API Key from [Dashboard API Keys
        Section](https://dashboard.interactly.ai/api-keys).

````