---
title: "Get Component Descriptor (getComponentDescriptorByClazz)"
method: GET
path: "/api/component/{componentDescriptorClazz}"
tags: ["component-descriptor-controller"]
---

# Get Component Descriptor (getComponentDescriptorByClazz)

`GET /api/component/{componentDescriptorClazz}`

Gets the Component Descriptor object using class name from the path parameters. Each Component Descriptor represents configuration of specific rule node (e.g. 'Save Timeseries' or 'Send Email'.). The Component Descriptors are used by the rule chain Web UI to build the configuration forms for the rule nodes. The Component Descriptors are discovered at runtime by scanning the class path and searching for @RuleNode annotation. Once discovered, the up to date list of descriptors is persisted to the database.

Available for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority.

## Path parameters

- `componentDescriptorClazz` string, required

## Response `200`

OK

- ComponentDescriptor
  - `id` ComponentDescriptorId
    - `id` string, uuid, required — string
  - `createdTime` integer — Timestamp of the descriptor creation, in milliseconds
  - `type` 'ENRICHMENT' | 'FILTER' | 'TRANSFORMATION' | 'ACTION' | 'EXTERNAL' | 'FLOW' — Type of the Rule Node
  - `scope` 'TENANT' — Scope of the Rule Node. Always set to 'TENANT', since no rule chains on the 'SYSTEM' level yet.
  - `clusteringMode` 'USER_PREFERENCE' | 'ENABLED' | 'SINGLETON' — Clustering mode of the RuleNode. This mode represents the ability to start Rule Node in multiple microservices.
  - `name` string — Name of the Rule Node. Taken from the @RuleNode annotation.
  - `clazz` string — Full name of the Java class that implements the Rule Engine Node interface.
  - `configurationVersion` integer — Rule node configuration version. By default, this value is 0. If the rule node is a versioned node, this value might be greater than 0.
  - `actions` string — Rule Node Actions. Deprecated. Always null.
  - `hasQueueName` boolean — Indicates that the RuleNode supports queue name configuration.
  - `configurationDescriptor` unknown

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)