Skip to main content
POST
Send a signed event to a fleet

Path Parameters

fleet_id
string<uuid>
required

Fleet identifier returned by fleet creation or agentsfleet install --library <LIBRARY_ID>.

Body

application/json
event_id
string
required

Unique event identifier. Duplicates within 24 hours are ignored.

type
string
required

Event type label (e.g. email.received, push, payment.succeeded).

data
object
required

Event payload — any JSON object. Passed as-is into the fleet event loop.

Response

Duplicate event or event ignored because the fleet is paused.

status
string
Allowed value: "duplicate"
ignored
string

Reason the event was ignored (e.g. fleet_paused).