List Asset Categories

GET 
/organizations/:organizationId/asset-categories

List asset categories

Request

Path Parameters

organizationId stringrequired

The ID of organization.

Query Parameters

maxResults number

The maximum number of results to return.

nextToken string

To retrieve the next set of results.

Responses

200

application/json

Schema

Schema

data object[]required
Data of the asset categories.
Array [
id stringrequired
organizationId stringrequired
name stringrequired
description stringrequired
image stringrequired
createdBy stringrequired
createdAtDateString numberrequired
createdAt numberrequired
updatedBt stringrequired
updatedAtDateString numberrequired
updatedAt numberrequired
]

Example (from schema)

{
  "data": [
    {
      "id": "string",
      "organizationId": "string",
      "name": "string",
      "description": "string",
      "image": "string",
      "createdBy": "string",
      "createdAtDateString": 0,
      "createdAt": 0,
      "updatedBt": "string",
      "updatedAtDateString": 0,
      "updatedAt": 0
    }
  ]
}

Example

{
  "data": [
    {
      "id": "ac-assetCategoryId",
      "organizationid": "o-organizationId",
      "name": "IDT-Bot-Asset-Category-A",
      "description": "IDT-Asset-Category-A-Description",
      "image": "Asset-CategoryId-Image.png",
      "createdBy": "d6b0e137-xxxx-xxxx-xxxx-c944cc12a5f4",
      "createdAtDateString": "2024-01-01T00:00:00.000Z",
      "createdAt": 1700000000000,
      "updatedBy": "d6b0e137-xxxx-xxxx-xxxx-c944cc12a5f4",
      "updatedAtDateString": "2024-01-31T00:00:00.000Z",
      "updatedAt": 1710000000000
    }
  ]
}

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...