---
title: "Assign rule chain to edge (assignRuleChainToEdge)"
method: POST
path: "/api/edge/{edgeId}/ruleChain/{ruleChainId}"
tags: ["rule-chain-controller"]
---

# Assign rule chain to edge (assignRuleChainToEdge)

`POST /api/edge/{edgeId}/ruleChain/{ruleChainId}`

Creates assignment of an existing rule chain to an instance of The Edge. Assignment works in async way - first, notification event pushed to edge service queue on platform. Second, remote edge service will receive a copy of assignment rule chain (Edge will receive this instantly, if it's currently connected, or once it's going to be connected to platform). Third, once rule chain will be delivered to edge service, it's going to start processing messages locally. 

Only rule chain with type 'EDGE' can be assigned to edge.

Available for users with 'TENANT_ADMIN' authority.

## Path parameters

- `edgeId` string, required
- `ruleChainId` string, required

## Response `200`

OK

- RuleChain — A JSON value representing the rule chain.
  - `id` RuleChainId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'RULE_CHAIN', required — string
  - `createdTime` integer — Timestamp of the rule chain creation, in milliseconds
  - `tenantId` TenantId, required
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'TENANT', required — string
  - `name` string, required — Rule Chain name
  - `type` 'CORE' | 'EDGE' — Rule Chain type. 'EDGE' rule chains are processing messages on the edge devices only.
  - `firstRuleNodeId` RuleNodeId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'RULE_NODE', required — string
  - `root` boolean — Indicates root rule chain. The root rule chain process messages from all devices and entities by default. User may configure default rule chain per device profile.
  - `debugMode` boolean — Reserved for future usage.
  - `version` integer
  - `configuration` unknown
  - `additionalInfo` 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)