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.

GET /api/models

Get models

cURL

curl --request GET \
  --url http://localhost:3000/api/models \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "<string>",
    "user_id": "<string>",
    "name": "<string>",
    "access_control_list": [
      {
        "roles": [
          {
            "name": "<string>",
            "permissions": [
              {
                "action": "View",
                "scopes": [
                  "<string>"
                ]
              }
            ]
          }
        ],
        "user_id": "<string>",
        "group_id": "<string>",
        "invite_id": "<string>",
        "email": "[e-mail]"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z"
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

fields · string

Comma-separated list of fields to include in the response

name · string

Filter models by name

teamId · string

Team ID to filter models by team workspace (shows only models that belong to this specific team)

Response

200

application/json

List of models or a specific model

id · string · required

Unique identifier for the model

user_id · string · required

ID of the user who owns this model

name · string · required

Name of the model

access_control_list · object[] · required

Access control list for the model

Show child attributes

created_at · string<date-time> · required

Creation timestamp