Creates new model

POST 
https://apis.<domain>/iot/models

Authorization: http

name: bearerTokentype: httpscheme: bearerin: headerdescription: Authorization Header: `Authorization: Bearer <user_token>`

Creates new model. User identified by the provided access token will be the model's owner.

Authorization Action:

core:models:create

Request

application/json

Body

required

JSON-formatted document describing the new model.

id uuid

Unique model identifier.

name string

Free-form model name.

description string

Free-form model description.

metadata object

Arbitrary, object-encoded model data.

tags string[]

List of tags associated with the model.

tenants string[]

List of tenants that can access this model.

image string

URL to model image.

created_at date-time

Time when the model was created.

updated_at date-time

Time when the model was last updated.

Responses

201

Model created successfully.

Response Headers

• Location string

  URL to created model resource.

400

Failed due to malformed JSON.

401

Missing or invalid access token provided.

409

Entity already exist.

415

Missing or invalid content type.

500

Unexpected server error.

application/json

Schema

Schema

• string byte

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'https://apis.<domain>/iot/models' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "description": "string",
  "metadata": {},
  "tags": [
    "string"
  ],
  "tenants": [
    "string"
  ],
  "image": "string",
  "created_at": "2025-01-14T09:16:36.664Z",
  "updated_at": "2025-01-14T09:16:36.664Z"
}'

Request Collapse all

Base URL

https://apis.<domain>

Auth

Bearer Token

Body required

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "description": "string",
  "metadata": {},
  "tags": [
    "string"
  ],
  "tenants": [
    "string"
  ],
  "image": "string",
  "created_at": "2025-01-14T09:16:36.664Z",
  "updated_at": "2025-01-14T09:16:36.664Z"
}