Get UI-optimized agent organization

GET

/api/agents/architecture/ui-organization

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

Return agents grouped as divine/background/active/hybrid for UI rendering.

The manager pre-filters background/active/hybrid to user_visible agents.

Responses

200

Successful Response

UIOrganizationResponse

Agents grouped for the architecture UI (divine + background + active + hybrid).

Mirrors AgentArchitectureManager.get_ui_organization(). Background/active/hybrid lists are already filtered to user_visible=True by the manager; divine agents are emitted in full (they’re always user-visible in this system).

object

divine

Divine

Divine agents

Array<object>

UIAgentInfo

Agent row rendered in the architecture UI organization view.

Mirrors what AgentArchitectureManager.get_ui_organization() emits per agent across the divine/background/active/hybrid groups. Fields beyond id/name/status are optional because group-specific payloads differ (e.g. divine agents carry authority_level; background agents carry can_modify_system; active agents carry depends_on).

object

id

required

Id

Agent ID

string

name

required

Name

Display name

string

status

required

Status

Current operational status

string

description

Any of:

string

string

null

null

category

Any of:

string

string

null

null

priority

Any of:

string

string

null

null

autoStart

Any of:

boolean

boolean

null

null

canModifySystem

Any of:

boolean

boolean

null

null

authorityLevel

Any of:

string

string

null

null

dependsOn

Any of:

Array<string>

Array<string>

null

null

agentType

Any of:

string

string

null

null

healthLevel

Any of:

string

string

null

null

capabilities

Any of:

Array<string>

Array<string>

null

null

background

Background

Background agents

Array<object>

UIAgentInfo

Agent row rendered in the architecture UI organization view.

Mirrors what AgentArchitectureManager.get_ui_organization() emits per agent across the divine/background/active/hybrid groups. Fields beyond id/name/status are optional because group-specific payloads differ (e.g. divine agents carry authority_level; background agents carry can_modify_system; active agents carry depends_on).

object

id

required

Id

Agent ID

string

name

required

Name

Display name

string

status

required

Status

Current operational status

string

description

Any of:

string

string

null

null

category

Any of:

string

string

null

null

priority

Any of:

string

string

null

null

autoStart

Any of:

boolean

boolean

null

null

canModifySystem

Any of:

boolean

boolean

null

null

authorityLevel

Any of:

string

string

null

null

dependsOn

Any of:

Array<string>

Array<string>

null

null

agentType

Any of:

string

string

null

null

healthLevel

Any of:

string

string

null

null

capabilities

Any of:

Array<string>

Array<string>

null

null

active

Active

Active agents

Array<object>

UIAgentInfo

Agent row rendered in the architecture UI organization view.

Mirrors what AgentArchitectureManager.get_ui_organization() emits per agent across the divine/background/active/hybrid groups. Fields beyond id/name/status are optional because group-specific payloads differ (e.g. divine agents carry authority_level; background agents carry can_modify_system; active agents carry depends_on).

object

id

required

Id

Agent ID

string

name

required

Name

Display name

string

status

required

Status

Current operational status

string

description

Any of:

string

string

null

null

category

Any of:

string

string

null

null

priority

Any of:

string

string

null

null

autoStart

Any of:

boolean

boolean

null

null

canModifySystem

Any of:

boolean

boolean

null

null

authorityLevel

Any of:

string

string

null

null

dependsOn

Any of:

Array<string>

Array<string>

null

null

agentType

Any of:

string

string

null

null

healthLevel

Any of:

string

string

null

null

capabilities

Any of:

Array<string>

Array<string>

null

null

hybrid

Hybrid

Hybrid agents

Array<object>

UIAgentInfo

Agent row rendered in the architecture UI organization view.

Mirrors what AgentArchitectureManager.get_ui_organization() emits per agent across the divine/background/active/hybrid groups. Fields beyond id/name/status are optional because group-specific payloads differ (e.g. divine agents carry authority_level; background agents carry can_modify_system; active agents carry depends_on).

object

id

required

Id

Agent ID

string

name

required

Name

Display name

string

status

required

Status

Current operational status

string

description

Any of:

string

string

null

null

category

Any of:

string

string

null

null

priority

Any of:

string

string

null

null

autoStart

Any of:

boolean

boolean

null

null

canModifySystem

Any of:

boolean

boolean

null

null

authorityLevel

Any of:

string

string

null

null

dependsOn

Any of:

Array<string>

Array<string>

null

null

agentType

Any of:

string

string

null

null

healthLevel

Any of:

string

string

null

null

capabilities

Any of:

Array<string>

Array<string>

null

null