Create Agent

LLM-friendly URL
POST
https://api.luzmo.com/0.1.0/agent

Create a reusable Agent configuration. An Agent uses automatic routing to choose among its enabled capabilities when invoked through AIPrompt with agent_id .

The authenticated user becomes the creator and initial owner. Creating Agents requires a Designer or Owner organization role. See Creating and using Agents through the API for an end-to-end example.

Request parametersResponse schema
id UUID

The unique identifier of the entity

name OBJECT

Localized Agent name.

en STRING
description OBJECT

Localized public description of the Agent. This is display metadata and is not added to the AI prompt.

en STRING
capabilities ARRAY[STRING]

Capabilities the Agent may use. An empty array enables every capability available to the authenticated user.

value STRING
theme_id STRING

Platform theme slug or custom Theme ID used by clients to present Agent-generated assets. AIPrompt does not load or apply this theme to its response.

user_id UUID

Identifier of the user who created the Agent. This creator reference does not change when ownership is shared or reassigned.

shareable_id UUID

Identifier of the Shareable record that controls modification and ownership. Agent discovery and use remain organization-wide.

created_at DATETIME

RFC 3339 date time string indicating when the resource was created

updated_at DATETIME

RFC 3339 date time string indicating when the resource was last updated

Can be executed by:
Organization Editor
Can be associated to:
Securables
linked_rules
User
Shareable
Did this page help you?
Yes No
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.create('agent',
  {
    name: {
      en: "Revenue assistant"
    },
    description: {
      en: "Answers revenue questions and creates supporting charts."
    },
    capabilities: [
      "data_analysis",
      "chart_creation"
    ],
    theme_id: "default"
  }
);
You are not authenticated.
Log in to try
Example Response
200
400
500
{
  "id": "4ae128cc-1376-4f3f-876d-09b2a841f906",
  "name": {
    "en": "Revenue assistant"
  },
  "description": {
    "en": "Answers revenue questions and creates supporting charts."
  },
  "capabilities": [
    "data_analysis",
    "chart_creation"
  ],
  "theme_id": "default",
  "user_id": "444e2d0c-8dfb-45c1-bb97-52cb9264671f",
  "shareable_id": "5a96ab29-86d7-4855-93ce-a9cfc9b138c5",
  "created_at": "2026-09-29T08:48:21.140Z",
  "updated_at": "2026-09-29T08:48:21.140Z"
}