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

> Retrieves a list of models or a specific model by name. When teamId is provided, returns only models that belong to that specific team (requires team membership). When no teamId is provided, returns models the user has individual access to through model_ownership.



## OpenAPI

````yaml get /api/models
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:
    get:
      tags:
        - models
      summary: Get models
      description: >-
        Retrieves a list of models or a specific model by name. When teamId is
        provided, returns only models that belong to that specific team
        (requires team membership). When no teamId is provided, returns models
        the user has individual access to through model_ownership.
      parameters:
        - name: fields
          in: query
          description: Comma-separated list of fields to include in the response
          schema:
            type: string
        - name: name
          in: query
          description: Filter models by name
          schema:
            type: string
        - name: teamId
          in: query
          description: >-
            Team ID to filter models by team workspace (shows only models that
            belong to this specific team)
          schema:
            type: string
      responses:
        '200':
          description: List of models or a specific model
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Model'
        '401':
          description: Not authenticated
        '403':
          description: Not authorized - user not a member of the specified team
        '404':
          description: Resource not found
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Model:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the model
        user_id:
          type: string
          description: ID of the user who owns this model
        name:
          type: string
          description: Name of the model
        access_control_list:
          type: array
          items:
            type: object
            properties:
              user_id:
                type: string
              group_id:
                type: string
              invite_id:
                type: string
              email:
                type: string
                format: email
              roles:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    permissions:
                      type: array
                      items:
                        type: object
                        properties:
                          action:
                            type: string
                            enum:
                              - View
                              - Edit
                              - Comment
                              - Invite Collaborator
                              - Manage Model
                          scopes:
                            type: array
                            items:
                              type: string
                        required:
                          - action
                          - scopes
                  required:
                    - name
                    - permissions
            required:
              - roles
          description: Access control list for the model
        created_at:
          type: string
          format: date-time
          description: Creation timestamp
      required:
        - id
        - user_id
        - name
        - access_control_list
        - created_at
    Error:
      type: object
      description: Standard error response
      properties:
        message:
          type: string
          description: Human-readable error message
        code:
          type: string
          description: Application-specific error code
        details:
          description: Additional error details (optional)
      required:
        - message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````