Account settings

Account settings apply to every AI Visibility project in an account. They control when scheduled prompt runs execute and provide the defaults a new project starts from.

Read account settings

Operation: query GetAiVisibilityAccountSettings($accountId: ObjectID!) { getAiVisibilityAccountSettings(accountId: $accountId) { scheduleType timezone aiProvidersSyncWithSubscription defaultCountry defaultLanguage } }Variables: { "accountId": "TjAwN0FjY291bnQxMjM0NQ" }

GetAiVisibilityAccountSettingsTry in Explorer

GraphQL

query GetAiVisibilityAccountSettings($accountId: ObjectID!) {
  getAiVisibilityAccountSettings(accountId: $accountId) {
    scheduleType
    timezone
    aiProvidersSyncWithSubscription
    defaultCountry
    defaultLanguage
  }
}

Field	Description
scheduleType	Instant runs scheduled prompts in real time; Delayed batches them at local midnight.
timezone	IANA timezone (e.g. Europe/London) that defines midnight for delayed scheduling.
aiProvidersSyncWithSubscription	When true, providers included in the subscription are added to projects automatically. Read-only for customers; ask Lumar support to change it.
defaultCountry	ISO 3166-1 alpha-2 market copied onto a project created without a country. null means no default (worldwide).
defaultLanguage	ISO 639-1 generation language copied onto a project created without a language. null means no default.

An account that has not created a project yet returns the defaults it will be provisioned with: Instant, UTC, and no market defaults.

Update account settings

Operation: mutation UpdateAiVisibilityAccountSettings( $accountId: ObjectID! $defaultCountry: String $defaultLanguage: String ) { updateAiVisibilityAccountSettings( input: { accountId: $accountId defaultCountry: $defaultCountry defaultLanguage: $defaultLanguage } ) { aiVisibilityAccountSettings { scheduleType timezone aiProvidersSyncWithSubscription defaultCountry defaultLanguage } } }Variables: { "accountId": "TjAwN0FjY291bnQxMjM0NQ", "defaultCountry": "US", "defaultLanguage": "en" }

UpdateAiVisibilityAccountSettingsTry in Explorer

GraphQL

mutation UpdateAiVisibilityAccountSettings(
  $accountId: ObjectID!
  $defaultCountry: String
  $defaultLanguage: String
) {
  updateAiVisibilityAccountSettings(
    input: {
      accountId: $accountId
      defaultCountry: $defaultCountry
      defaultLanguage: $defaultLanguage
    }
  ) {
    aiVisibilityAccountSettings {
      scheduleType
      timezone
      aiProvidersSyncWithSubscription
      defaultCountry
      defaultLanguage
    }
  }
}

Omitted fields are left unchanged. For defaultCountry and defaultLanguage, pass null to clear the default.

How defaults flow to projects and prompts

Defaults are copied, not linked:

1. createAiVisibilityProject copies defaultCountry and defaultLanguage onto the project when the input omits country or language. An explicit null on the project input keeps the project worldwide or language-unspecified even when the account has a default.
2. createAiVisibilityPrompt and createAiVisibilityTopicsBulk copy the project's country onto a prompt created without an explicit country.

Because the value is copied at creation, changing an account default never rewrites existing projects, and changing a project's market never rewrites existing prompts or runs. Use updateAiVisibilityProject to change one project. See Projects for what the project fields do.

Unknown or malformed codes are rejected as input validation errors. Country is case-insensitive and stored upper-case; language must be lower-case.

caution

Switching scheduleType to Delayed, or changing timezone while delayed, moves every project's next scheduled run to the next local midnight in the new timezone.

Schema reference

• AiVisibilityAccountSettings -- Settings type
• UpdateAiVisibilityAccountSettingsInput -- Update input
• AiVisibilityScheduleType -- Schedule options

The generated schema-reference pages for these types appear after the next scheduled refresh from the production schema.