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

# Update an interface

> Updates a specific interface by ID



## OpenAPI

````yaml put /api/models/{modelId}/interfaces/{interfaceId}
openapi: 3.0.0
info:
  title: Dalus Public API Documentation
  version: 1.0.0
  description: Public API documentation for Dalus application
servers:
  - url: http://localhost:3000
    description: Dalus API Server
security:
  - bearerAuth: []
tags:
  - name: models
    description: AI model management endpoints
  - name: models/requirements
    description: Requirements management for models
  - name: models/actions
    description: Action management for models
  - name: models/parts
    description: Part management for models
  - name: models/states
    description: State management for models
  - name: models/transitions
    description: Transition relationship management for models
  - name: models/signals
    description: Signal relationship management for models
  - name: models/interfaces
    description: Interface relationship management for models
  - name: models/ports
    description: Port management for models
paths:
  /api/models/{modelId}/interfaces/{interfaceId}:
    put:
      tags:
        - models/interfaces
      summary: Update an interface
      description: Updates a specific interface by ID
      parameters:
        - name: modelId
          in: path
          required: true
          description: ID of the model
          schema:
            type: string
            format: uuid
        - name: interfaceId
          in: path
          required: true
          description: ID of the interface
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                sourceId:
                  type: string
                  description: ID of the source part
                targetId:
                  type: string
                  description: ID of the target part
                type:
                  type: string
                  description: Type of interface
                name:
                  type: string
                  description: Name of the interface
                description:
                  type: string
                  description: Description of the interface
                metadata:
                  type: object
                  description: Additional metadata for the interface
      responses:
        '200':
          description: Interface updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Interface'
        '400':
          description: Invalid model ID or interface ID
        '401':
          description: Not authenticated
        '403':
          description: Forbidden - insufficient permissions
        '404':
          description: Model or interface not found
        '500':
          description: Server error
components:
  schemas:
    Interface:
      type: object
      properties:
        id:
          type: string
          description: The id of the edge
        type:
          type: string
          description: The type of the edge
        source:
          type: string
          description: The source node id
        target:
          type: string
          description: The target node id
        data:
          type: object
          properties:
            label:
              type: string
            connections:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                  type:
                    type: string
                    enum:
                      - Matter
                      - Information
                      - Energy
                      - Binding
                  direction:
                    type: string
                    enum:
                      - in
                      - out
                      - both
                  subType:
                    type: string
                    enum:
                      - Fixed
                      - Movable
                      - Fastener
                      - Adhesive
                      - Friction
                      - Form-fit
                      - 'N2 (g): Nitrogen gas'
                      - 'O2 (g): Oxygen gas'
                      - 'Ar (g): Argon gas'
                      - 'He (g): Helium gas'
                      - 'H2 (g): Hydrogen gas'
                      - 'CO2 (g): Carbon dioxide gas'
                      - 'CH4 (g): Methane gas'
                      - Air (mixture of N2, O2, and other gases)
                      - 'H2O (l): Water'
                      - 'C8H18 (l): Octane (representing fuel)'
                      - 'C2H5OH (l): Ethanol'
                      - 'C3H8O (l): Isopropyl alcohol'
                      - 'H2SO4 (l): Sulfuric acid'
                      - 'HCl (l): Hydrochloric acid'
                      - 'NaOH (aq): Sodium hydroxide solution'
                      - Hydraulic fluid
                      - 'LOX: Liquid oxygen'
                      - 'RP-1: Rocket propellant 1'
                      - UART (Universal Asynchronous Receiver/Transmitter)
                      - >-
                        USART (Universal Synchronous/Asynchronous
                        Receiver/Transmitter)
                      - SPI (Serial Peripheral Interface)
                      - I2C (Inter-Integrated Circuit)
                      - CAN (Controller Area Network)
                      - USB (Universal Serial Bus)
                      - Ethernet
                      - RS-232
                      - RS-485
                      - Bluetooth
                      - Wi-Fi (IEEE 802.11)
                      - ARINC 429
                      - MQTT (Message Queuing Telemetry Transport)
                      - Electrical
                      - Electromagnetic
                      - Mechanical
                      - Thermal
                      - Chemical
                      - Nuclear
                  variableId:
                    type: string
                  propertyIds:
                    type: array
                    items:
                      type: string
                  colorGroup:
                    type: string
                  matterState:
                    type: string
                    enum:
                      - solid
                      - liquid
                      - gas
                  referenceEdgeId:
                    type: string
                required:
                  - id
                  - type
                  - direction
                  - subType
                  - variableId
                  - propertyIds
                  - matterState
            notes:
              type: string
          required:
            - label
            - connections
          additionalProperties: true
          description: The data associated with the edge
      required:
        - id
        - type
        - source
        - target
        - data
      description: An interface between parts in the model consisting of connections
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````