GEO

Replace a project's GEO settings

Changed on

Writes the full settings document and re-arms the recurring scan. Engines must be ids from the model catalog this organization can see (the ones GET /geo/settings returns) and languages must be supported languages; an unknown value is rejected with a 400 instead of being replaced by a default. Zero data retention is forced off without the ZDR add-on, and engines that are not visible to this caller keep their stored selection. Competitors are managed through the competitors endpoints and are not part of this payload. The language the project's prompts are written in always stays tracked: leaving it out of languages adds it back as the first entry, and a full list without it is rejected with a 400.

patch/v1/projects/{projectId}/geo/settings

Request

  • Base URL: https://api.usenotra.com
  • URL: https://api.usenotra.com/v1/projects/{projectId}/geo/settings
  • Auth: HTTP bearer

Path parameters

projectIdstring required
Example:b1f2c3d4-0000-4000-8000-000000000000

Request body

companyNamestring required
aliasesstring[] required
conversionPathsstring[]

Paths that count as a conversion when an AI referral reaches them. Prefix match. Omit to keep the stored list.

domainsstring[]

Additional hostnames that send AI traffic to this project, besides the brand website. Subdomains of a listed domain are included. Omit to keep the stored list.

languagesstring[] required
enginesstring[] required
enforceZdrboolean required
nonZdrApprovedEnginesstring[] required
trackWithoutSearchboolean

Also scan search-capable models without web search. Omit to keep the stored value (default false).

pausedAutoPromptIdsstring[]

Ids of auto-generated prompts to skip in scans. Omit to keep the current list.

removedAutoPromptIdsstring[]

Ids of auto-generated prompts removed from tracking. Omit to keep the current list.

enabledboolean required
scanIntervalHoursinteger required

Hours between automatic scans, 24-2160, in whole days (multiple of 24). Presets: 24, 48, 72, 168, 336, 720.

Response

Settings updated successfully

configuredboolean required

Whether the analytics backend is configured.

Changes

    • info

      added the new optional request property

    • info

      added the required property / to the response with the status

    • info

      added the new optional request property

    • info

      added the required property / to the response with the status