BrightshoalDocsOpen console
MenuAudit log

API reference

Audit log

Who changed what in your organization, newest first.

List audit log entries

GET/api/audit-log

Who changed what (assistants, keys, numbers, knowledge, takeovers and more), newest first, one cursor page at a time. A project-scoped key sees only that project's entries.

Secret API key. How it works

Query parameters

  • limitinteger1 to 200

    Page size.

    Default 50

  • cursorstring

    next_cursor from the previous page.

Returns

200 OK

Response attributes
  • dataarray of AuditEntryrequired

    11 attributes
    • idstringrequired

    • org_idstringrequired

    • project_idstring | nullrequired

    • actor_typestringrequired

      One of user api_key

    • actor_idstringrequired

    • actor_labelstring | nullrequired

    • actionstringrequired

    • resource_typestringrequired

    • resource_idstring | nullrequired

    • metadataobject | nullrequired

    • created_atstringrequiredISO 8601 timestamp

  • next_cursorstring | nullrequired

    Opaque cursor for the next page.

  • has_morebooleanrequired

  • 401 Missing, malformed, unknown or revoked API key (unauthorized)
  • 403 Refused, for example a read-only key on a write (read_only_key), a role too low for the route (insufficient_role), or a route that needs a console session
  • 429 Rate limit exceeded (rate_limited). Wait Retry-After seconds. Budgets are per 60-second window: developer API 120 per key and 600 per organization; public chat 30 per IP address, except polling for updates (60 per conversation and IP address) and analytics events (120 per IP address).
GET /api/audit-log
curl "https://api.myleadsfactory.tech/api/audit-log" \
  -H "Authorization: Bearer $MLF_API_KEY"
Response 200
{
  "data": [
    {
      "id": "id_5f0c2a9e7b1d4c3e8a6f0b2d4c6e8a1f",
      "org_id": "org_5f0c2a9e7b1d4c3e8a6f0b2d4c6e8a1f",
      "project_id": "proj_5f0c2a9e7b1d4c3e8a6f0b2d4c6e8a1f",
      "actor_type": "user",
      "actor_id": "id_5f0c2a9e7b1d4c3e8a6f0b2d4c6e8a1f",
      "actor_label": "string",
      "action": "string",
      "resource_type": "string",
      "resource_id": "ksrc_5f0c2a9e7b1d4c3e8a6f0b2d4c6e8a1f",
      "metadata": {},
      "created_at": "2026-10-28T09:30:00.000Z"
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0xMC0yOCJ9",
  "has_more": true
}