Create Asset Category

POST 
/organizations/:organizationId/asset-categories

Create asset category

Request

Path Parameters

organizationId stringrequired

The ID of organization.

application/json

Body

required

name stringrequired

The name of asset category

description string

The description of asset category

attributes string[]

The custom attributes of asset category

Responses

200

application/json

Schema

Schema

data object[]required
Data of the asset.
Array [
id stringrequired
organizationId stringrequired
name stringrequired
description stringrequired
createdAtDateString stringrequired
createdAt numberrequired
]

Example (from schema)

{
  "data": [
    {
      "id": "string",
      "organizationId": "string",
      "name": "string",
      "description": "string",
      "createdAtDateString": "string",
      "createdAt": 0
    }
  ]
}

Example

{
  "data": {
    "id": "ac-assetCategoryId",
    "organizationid": "o-organizationId",
    "name": "IDT-Bot-Asset-Category",
    "description": "IDT-Asset-Category-Description",
    "createdAtDateString": "2024-01-01T00:00:00.000Z",
    "createdAt": 1704067200000
  }
}

401

The request has not permission.

application/json

Schema

Schema

error stringrequired

The request has not permission.

message stringrequired

The request has not permission message.

Example (from schema)

{
  "error": "string",
  "message": "string"
}

Example

{
  "error": "Unauthenticated",
  "message": "Authentication is required and has failed or has not yet been provided."
}

403

The request has not permission.

application/json

Schema

Schema

error stringrequired

The request has not permission.

message stringrequired

The request has not permission message.

Example (from schema)

{
  "error": "string",
  "message": "string"
}

Example

{
  "error": "Forbidden",
  "message": "Access to the requested resource is forbidden."
}

404

The resource hasn't found.

application/json

Schema

Schema

error stringrequired

The resource hasn't found.

message stringrequired

The resource hasn't found message.

Example (from schema)

{
  "error": "string",
  "message": "string"
}

Example

{
  "error": "ResourceNotFound",
  "message": "The requested resource could not be found."
}

422

The input data has invalid.

application/json

Schema

Schema

error stringrequired

The input data has invalid.

message stringrequired

The input data has invalid message.

Example (from schema)

{
  "error": "string",
  "message": "string"
}

Example

{
  "error": "ValidationError",
  "message": "Input data validation failed."
}

Loading...