> ## 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.

# Get a specific interface

> Retrieves a specific interface by ID



## OpenAPI

````yaml get /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}:
    get:
      tags:
        - models/interfaces
      summary: Get a specific interface
      description: Retrieves 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
      responses:
        '200':
          description: Interface details
          content:
            application/json:
              schema:
                allOf:
                  - type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: Unique identifier for the interface
                      modelId:
                        type: string
                        format: uuid
                        description: ID of the model this interface belongs to
                      sourceId:
                        type: string
                        description: ID of the source part
                      targetId:
                        type: string
                        description: ID of the target part
                      name:
                        type: string
                        description: Name of the interface
                      description:
                        type: string
                        description: Description of the interface
                      createdAt:
                        type: string
                        format: date-time
                        description: Creation timestamp
                      updatedAt:
                        type: string
                        format: date-time
                        description: Last update timestamp
                  - $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

````