Associate AIRule

LLM-friendly URL

POST

https://api.luzmo.com/0.1.0/airule

Link a rule to an Agent , using the role linked_agents . From then on, that Agent applies the published text of the rule.

An Agent reads the version the rule points at with published_version_id at the moment it runs, so unpublished edits never reach it: saving a draft on a published rule changes nothing for the Agent until you publish that version, and a rule that is not published contributes nothing at all, even while it is linked. You can link a draft rule up front and publish it later.

The same link can be created from the other side with Associate Agent , using the role linked_rules ; see Creating and using Agents through the API for an end-to-end example.

The call is checked on both ends: you need the Organization Member right on the rule, and the right to modify the Agent you are linking it to.

Request parameters

Response schema

Expand all

Reset

Can be executed by:

Organization Member

Entity Modifier

(For: linked_agents)

Can be associated to:

latest_version

published_version

versions

linked_agents

created_by

Did this page help you?

Yes

Language

Shell

Node

Java

.NET

Python

PHP

Install

npm install @luzmo/nodejs-sdk

Example Request

import Luzmo from '@luzmo/nodejs-sdk';
const client = new Luzmo({
  api_key: '<your Luzmo API key>',
  api_token: '<your Luzmo API token>',
  host: 'https://api.luzmo.com'
});

const response = await client.associate('airule',
  '< rule ID >',
  { role: 'linked_agents', id: '< agent ID >' }
);

Example Response

200

400

500

{
  "id": "c1f4a0c2-6c9e-4f6b-9a5a-3f0d2b8f1e77",
  "name": "Discount policy",
  "status": "published",
  "has_unpublished_changes": false,
  "latest_version_id": "2e7c8a10-4b3d-4a2f-9c1e-7d6b5a4f3e2d",
  "published_version_id": "2e7c8a10-4b3d-4a2f-9c1e-7d6b5a4f3e2d",
  "published_name": "Discount policy",
  "published_at": "2026-09-18T09:33:47.019Z",
  "organization_id": "0f2b8a6d-3c4e-4d5a-8b7c-1e2f3a4b5c6d",
  "user_id": "5ec6950f-d7bb-4554-8f6a-10ea8b68c254",
  "created_at": "2026-09-18T09:04:11.204Z",
  "updated_at": "2026-09-18T09:33:47.019Z"
}