Skip to main content
POST
Mark a new hire event as read
New hire monitoring requires a V2 workspace API key. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key.
Mark one event as read after your integration has handled it. The response returns the event with its read_at timestamp, and the monitor’s unread_event_count decreases. The request accepts an empty body or {}. A body that is present but not valid JSON returns 400.
The call is idempotent: marking an event that is already read returns it again with its first read_at. Webhook retries use the same event ID, so treat the event ID as the durable acknowledgement key.
Reading an event does not delete it. You can still retrieve it through List new hire events. Marking events read spends no credits.

Next step

Review Create a new hire monitor for webhook setup and signature verification.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Path Parameters

monitor_id
string<uuid>
required
event_id
string<uuid>
required

Body

application/json

Optional. Send no body or an empty JSON object ({}).

The body is of type object.

Response

The event after it was marked read.

event
object
required