# Account settings

https://api-docs.lumar.io/docs/ai-visibility/ai-visibility-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

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

**Variables:**
```json
{
  "accountId": "TjAwN0FjY291bnQxMjM0NQ"
}
```

| 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

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

**Variables:**
```json
{
  "accountId": "TjAwN0FjY291bnQxMjM0NQ",
  "defaultCountry": "US",
  "defaultLanguage": "en"
}
```

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](/docs/ai-visibility/ai-visibility-projects.md#market-country-and-language) 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.