Get Agent Status Snapshot
GET /api/etherforce/agent-status/{project_id}
GET
/api/etherforce/agent-status/{project_id}
Return the current FSM snapshot for every agent in this project.
Empty agents list when no handler has run yet for the project —
the frontend treats absent agents as IDLE with the bundled default
bark.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” project_id
required
Project Id
Active project id.
string
Active project id.
Responses
Section titled “ Responses ”Successful Response
AgentStatusSnapshotResponse
Snapshot of every active agent FSM for a project.
object
projectId
required
Projectid
string
agents
required
Agents
Array<object>
AgentStatusEntryOne agent’s current FSM state for a project.
object
agent
required
Agent
Lowercase agent identifier (hawken, lorekeeper, etc.).
string
state
required
State
Lifecycle state — one of idle / scanning / reporting / awaiting_confirmation.
string
updatedAt
required
Updatedat
ISO-8601 timestamp of the last transition.
string
Validation Error
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context