Retrieves models
GET/iot/models
Retrieves a list of models. Due to performance concerns, data is retrieved in subsets. The API must ensure that the entire dataset is consumed either by making subsequent requests, or by increasing the subset size of the initial request.
Authorization Action:
core:models:list
Request
Query Parameters
Possible values: >= 1
and <= 100
Default value: 10
Size of the subset to retrieve.
Number of items to skip during retrieval.
Name filter. Filtering is performed as a case-insensitive partial match.
Possible values: [name
, id
]
Default value: id
Order type.
Possible values: [asc
, desc
]
Default value: desc
Order direction.
Metadata filter. Filtering is performed matching the parameter with metadata on top level. Parameter is json.
Tag filter. Filtering is performed as a case-insensitive match.
Possible values: <= 64 characters
Tenant filter. Used to filter models by specific tenant.
Responses
- 200
- 400
- 401
- 422
- 500
List of models with pagination info.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
models object[]
Unique model identifier.
Free-form model name.
Free-form model description.
Arbitrary, object-encoded model data.
List of tags associated with the model.
List of tenants that can access this model.
URL to model image.
Time when the model was created.
Time when the model was last updated.
{
"total": 0,
"offset": 0,
"limit": 0,
"models": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"description": "string",
"metadata": {},
"tags": [
"string"
],
"tenants": [
"string"
],
"image": "string",
"created_at": "2025-01-14T09:16:36.675Z",
"updated_at": "2025-01-14T09:16:36.675Z"
}
]
}
Failed due to malformed query parameters.
Missing or invalid access token provided.
Database can't process request.
Unexpected server error.
- application/json
- Schema
Schema
- string byte