Safety

List limit hits

Each entry is an action Curviate refused (enforce) or warned about (warn) at a safety limit or pause, or a halt_cleared record of a pause lifted early. Read blocked and reason; filter by budget_row, since and until, and page until cursor is null.

get/v1/{account_id}/safety-events

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/safety-events
  • Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) whose safety events to read.

Query parameters

cursorstring

Pagination cursor from a previous response; decodable, pass it back verbatim.

budget_row'connection_requests_with_note' | 'connection_requests_no_note' | 'messages_first_degree' | 'inmail' | 'open_profile_inmail' | 'profile_views' | 'search' | 'comments' | 'post_likes' | 'follows' | 'content_poll' | 'job_poll' | 'posts' | 'endorsements' | 'invite_responses' | 'withdrawal_sweep' | 'total_actions' | 'pending_invites'

Return only events flagged against this budget row. Omit for every row.

sincestring

Only events at or after this instant (ISO-8601, e.g. 2026-09-01T00:00:00Z).

untilstring

Only events strictly before this instant (ISO-8601).

limitinteger

How many events to return per page, 1 to 100. Defaults to 50.

Response

What Curviate refused or warned about on this account, newest first. Filter by budget_row to ask about one action type, and by since / until to ask about a period.

object'safety_event_list' required

Response type discriminator.

cursorstring nullable required

Cursor for the next page; null on the terminal page. Pass it back verbatim. Page until cursor is null.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.