Returns a list of all configured agents including the local agent and remote agents
GET /api/agents
Auto-generated from server.go. Handler: s.handleGetAgents.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Successful response
Returns a list of all configured agents including the local agent and remote agents.
Schema hand-corrected in Session 9: original lift only saw 3 fields (action_endpoint, agent_id, healthy) but the handler emits 5 (adds last_seen, last_error with omitempty). action_endpoint is empty on the local agent and is also omitempty in spirit (always present in the wire shape today, but only meaningful for remotes).
object
object
Empty string for the local agent (added first with only AgentID + Healthy set). Non-empty URL for remote agents.
RFC3339-ish timestamp (“2006-01-02T15:04:05Z”). Only emitted for remote agents whose LastSeen is non-zero; the local agent and never-seen remotes omit it.
Most-recent dispatch error for the agent. Empty/omitted when no error. Only set for remote agents.
Authentication is required or the supplied token is invalid.
Standardised error envelope per RFC 7807. Many existing endpoints still
return an older shape (e.g. {"error": "..."}). This schema documents the
target shape; legacy endpoints will be migrated in Phase 70. Per D-21 the
spec describes current behaviour without enforcing the migration here.
object
A URI reference that identifies the problem type.
A short human-readable summary of the problem.
The HTTP status code generated by the origin server.
A human-readable explanation specific to this occurrence.
A URI reference that identifies the specific occurrence.
Legacy error message field. Will be removed once handlers are migrated.
Legacy per-field error details. Will be removed once handlers are migrated.
object
The request id middleware-assigned identifier for tracing.
Internal server error
Standardised error envelope per RFC 7807. Many existing endpoints still
return an older shape (e.g. {"error": "..."}). This schema documents the
target shape; legacy endpoints will be migrated in Phase 70. Per D-21 the
spec describes current behaviour without enforcing the migration here.
object
A URI reference that identifies the problem type.
A short human-readable summary of the problem.
The HTTP status code generated by the origin server.
A human-readable explanation specific to this occurrence.
A URI reference that identifies the specific occurrence.
Legacy error message field. Will be removed once handlers are migrated.
Legacy per-field error details. Will be removed once handlers are migrated.
object
The request id middleware-assigned identifier for tracing.