AgentResponseDto

Fields

Field	Type	Required	Description
id	String	:heavy_check_mark:	N/A
name	String	:heavy_check_mark:	N/A
identifier	String	:heavy_check_mark:	N/A
description	Optional<String>	:heavy_minus_sign:	N/A
behavior	AgentBehaviorDto	:heavy_check_mark:	N/A
active	boolean	:heavy_check_mark:	N/A
bridgeUrl	Optional<String>	:heavy_minus_sign:	Production bridge URL
devBridgeUrl	Optional<String>	:heavy_minus_sign:	Development bridge URL (set by npx novu dev)
devBridgeActive	Optional<Boolean>	:heavy_minus_sign:	Whether the dev bridge override is active
runtime	Optional<AgentResponseDtoRuntime>	:heavy_minus_sign:	Whether the agent brain is self-hosted (bridge) or managed by a third-party provider
visibility	Optional<Visibility>	:heavy_minus_sign:	Discovery scope of the agent. Always public today; reserved for the upcoming private-agents feature.
managedRuntime	Optional<ManagedRuntimeResponseDto>	:heavy_minus_sign:	Present when runtime is "managed". Contains provider and external identifiers.
environmentId	String	:heavy_check_mark:	N/A
organizationId	String	:heavy_check_mark:	N/A
createdBy	Optional<String>	:heavy_minus_sign:	Mongo user id of the user who created the agent
createdAt	String	:heavy_check_mark:	N/A
updatedAt	String	:heavy_check_mark:	N/A
integrations	List<AgentIntegrationSummaryDto>	:heavy_minus_sign:	N/A
exceedsPlanLimit	Optional<Boolean>	:heavy_minus_sign:	Cloud only. true when the agent falls outside the organization plan agent limit (by creation order among active agents — inactive agents do not consume slots). Only plan limits produce this flag — system-capped organizations (enterprise/unlimited tiers) are never over-limit. Over-limit agents are still stored but will not respond to inbound messages until the plan is upgraded or older agents are deactivated.