LLllmpulse
GEO Audits

Update a GEO audit

Changed on

Updates the schedule, the email alerts or the status. Making an audit recurring or resuming it counts against the plan limit of active recurring audits (ERR_LIMIT_REACHED). Requires a read_write scope API key and, for team members, update permission on GEO Audits.

patch/geo_audits/{id}

Request

  • Base URL
    https://api.llmpulse.ai/api/v1
  • URL
    https://api.llmpulse.ai/api/v1/geo_audits/{id}
  • Auth
    API key in header Authorization

Path parameters

idstring required

Audit id

Request body

project_idinteger
cadence'once' | 'weekly' | 'monthly'
schedule_dayinteger

Weekly: 0 (Sunday) to 6. Monthly: 1 to 28.

schedule_hourinteger

Hour of the day, 0 to 23, in the audit time zone

status'active' | 'paused' | 'archived'

paused stops scheduled runs, active resumes them, archived is the same as DELETE

email_alertsboolean

Response

The updated audit

idstring

Stable audit id

audit_type'agent_readiness' | 'robots_txt' | 'crawlability' | 'schema' | 'content_readiness' | 'discoverability' | 'site_structure'
targetstring

The audited domain (site-wide types) or page URL, normalized

country_codestring nullable
cadence'once' | 'weekly' | 'monthly'
status'active' | 'paused' | 'archived'
paused_reasonstring nullable

Null unless status is paused. user (paused by hand), unreachable (three runs in a row could not reach the site) or quota (the account has more active recurring audits than its plan allows; resume it once there is room)

next_run_atstring date-time nullable
email_alertsboolean
recurring_availableboolean

Whether this audit type can run weekly or monthly

checks_trackedboolean

Whether runs of this type produce findings and issues, or a score only

open_issuesinteger
open_critical_issuesinteger
created_atstring date-time
app_urlstring
project_idinteger
request_idstring

Changes