Create Asset

POST 
/api/v1/assets

Create a new Asset. Requires editor role.

Request

application/json

Body

Body

workspace stringrequired
Name of the Workspace
Example: Workspace 1
asset stringrequired
Name of the Asset
Example: Asset 1
type string
Type of the Asset
Default value: Default
Example: Vessel
description stringnullable
Description of the Asset
Example: Description

Responses

201

Success

application/json

Schema

Schema

id integerrequired
ID of the Asset
Possible values: > 0
Example: 1000
name stringrequired
Name of the Asset
Example: Asset 1
createdAt date-timerequired
Creation Date of the Asset
Example: 2025-08-25T19:29:40.666Z
updatedAt date-timerequired
Update Date of the Asset
Example: 2025-08-25T19:29:40.666Z
type stringrequired
Type of the Asset
Example: Vessel
description stringnullablerequired
Description of the Asset
Example: Description

workspace

object

required

id integerrequired

ID of the Workspace

Possible values: > 0

Example: 1000

name stringrequired

Name of the Workspace

Example: Workspace 1

Example (from schema)

{
  "id": 1000,
  "name": "Asset 1",
  "createdAt": "2025-08-25T19:29:40.666Z",
  "updatedAt": "2025-08-25T19:29:40.666Z",
  "type": "Vessel",
  "description": "Description",
  "workspace": {
    "id": 1000,
    "name": "Workspace 1"
  }
}

400

Validation Error

application/json

Schema

Schema

status stringrequired

Possible values: [Validation Error]

errors

object[]

required

Array [

error stringrequired

location stringrequired

Possible values: [body, query, path, headers]

]

Example (from schema)

{
  "status": "Validation Error",
  "errors": [
    {
      "error": "string",
      "location": "body"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

status stringrequired

Possible values: [Unauthorized]

Example (from schema)

{
  "status": "Unauthorized"
}

403

Forbidden

application/json

Schema

Schema

status stringrequired

Possible values: [Forbidden]

Example (from schema)

{
  "status": "Forbidden"
}

404

Workspace not found

application/json

Schema

Schema

status stringrequired

Possible values: [Workspace not found]

Example (from schema)

{
  "status": "Workspace not found"
}

409

Asset already exists

application/json

Schema

Schema

status stringrequired

Possible values: [Asset already exists]

Example (from schema)

{
  "status": "Asset already exists"
}

Loading...