Agent schema - Novu

Agent

An agent is a conversational assistant scoped to an environment. Agents receive inbound messages from linked channel integrations and respond through a self-hosted bridge or a managed runtime provider. Read more in the agents overview.

Field	Type	Description
`_id`	string	Unique identifier of the agent record in the database.
`name`	string	Display name shown in connected channels such as Slack and Microsoft Teams.
`identifier`	string	External slug used in API paths and SDK calls. Unique per environment. Maximum 60 characters, and must be a slug (alphanumeric characters separated by `-`, `_`, or `.`, for example `support-bot`).
`description`	string	Optional summary of the agent’s purpose.
`active`	boolean	Whether the agent accepts inbound messages.
`runtime`	string	Agent brain mode: `self-hosted` (bridge) or `managed` (provider-hosted).
`bridgeUrl`	string	Production bridge URL registered for self-hosted agents.
`devBridgeUrl`	string	Development bridge URL set by `npx novu dev`.
`devBridgeActive`	boolean	Whether the development bridge override is active.
`behavior`	object	Optional delivery behavior such as acknowledgement and reaction settings.
`managedRuntime`	object	Present when `runtime` is `managed`. Contains provider identifiers, tools, MCP servers, and system prompt metadata.
`integrations`	array	Summary of channel integrations linked to the agent.
`_environmentId`	string	Environment the agent belongs to.
`_organizationId`	string	Organization that owns the agent.
`createdAt`	string	ISO timestamp when the agent was created.
`updatedAt`	string	ISO timestamp when the agent was last updated.

Track activity and engagement events

Create an agent

⌘I