> ## Documentation Index > Fetch the complete documentation index at: https://docs.usenotra.com/llms.txt > Use this file to discover all available pages before exploring further. # Replace a project's GEO settings > 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. ## OpenAPI ````yaml https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/settings openapi: 3.1.1 info: title: Notra API version: 1.0.0 description: >- OpenAPI schema for Notra content endpoints. Use GET /v1/status for public reachability. Error responses include recovery guidance. servers: - url: https://api.usenotra.com description: Production security: - BearerAuth: [] tags: - name: Discovery description: Public API status and authenticated workspace discovery. - name: Content description: >- Manage posts, brand identities, and GitHub or Linear integrations, and queue content generation. Organization is inferred from the API key (identity.externalId). - name: Schedules description: >- Manage scheduled content generation. Organization is inferred from the API key (identity.externalId). - name: Event Triggers description: >- Manage event-based content generation triggered by GitHub webhooks. Organization is inferred from the API key (identity.externalId). - name: Chats description: >- Manage chat sessions. Organization is inferred from the API key (identity.externalId). - name: Skills description: >- Manage reusable writing skills. Organization is inferred from the API key (identity.externalId). - name: Feedback description: >- Collect and triage feedback submitted by AI agents. Agents post to the organization's feedback URL without credentials; reading and triage require an API key with feedback.read or feedback.write. - name: GEO description: >- Manage generative engine optimization: projects, tracking settings, prompts, prompt sequences, competitors, scans, visibility reads, content gaps and briefs, agent readiness and AI traffic. Project-scoped endpoints require the GEO plan entitlement in addition to their scope; organization-level ingest endpoints require only the traffic scope. paths: /v1/projects/{projectId}/geo/settings: patch: tags: - GEO summary: Replace a project's GEO settings description: >- 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. operationId: updateGeoSettings parameters: - schema: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ example: b1f2c3d4-0000-4000-8000-000000000000 required: true name: projectId in: path requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PatchGeoSettingsRequest' responses: '200': description: Settings updated successfully content: application/json: schema: $ref: '#/components/schemas/GeoSettingsResponse' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: GEO plan or available AI credits required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Organization, project or resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Authentication or billing service unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: PatchGeoSettingsRequest: type: object properties: companyName: type: string minLength: 1 maxLength: 128 aliases: type: array items: type: string minLength: 1 maxLength: 128 maxItems: 10 conversionPaths: type: array items: type: string minLength: 1 maxLength: 200 maxItems: 20 description: >- Paths that count as a conversion when an AI referral reaches them. Prefix match. Omit to keep the stored list. domains: type: array items: type: string minLength: 1 maxLength: 128 maxItems: 20 description: >- 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. languages: type: array items: type: string minLength: 1 maxLength: 128 minItems: 1 maxItems: 4 engines: type: array items: type: string minLength: 1 maxLength: 128 minItems: 1 maxItems: 64 enforceZdr: type: boolean nonZdrApprovedEngines: type: array items: type: string minLength: 1 maxLength: 128 maxItems: 64 trackWithoutSearch: type: boolean description: >- Also scan search-capable models without web search. Omit to keep the stored value (default false). pausedAutoPromptIds: type: array items: type: string minLength: 1 maxLength: 128 maxItems: 8 description: >- Ids of auto-generated prompts to skip in scans. Omit to keep the current list. removedAutoPromptIds: type: array items: type: string minLength: 1 maxLength: 128 maxItems: 8 description: >- Ids of auto-generated prompts removed from tracking. Omit to keep the current list. enabled: type: boolean scanIntervalHours: type: integer minimum: 24 maximum: 2160 description: >- Hours between automatic scans, 24-2160, in whole days (multiple of 24). Presets: 24, 48, 72, 168, 336, 720. required: - companyName - aliases - languages - engines - enforceZdr - nonZdrApprovedEngines - enabled - scanIntervalHours GeoSettingsResponse: type: object properties: configured: type: boolean description: Whether the analytics backend is configured. settings: $ref: '#/components/schemas/GeoSettings' organization: type: object properties: id: type: string slug: type: string name: type: string logo: type: - string - 'null' required: - id - slug - name - logo required: - configured - settings - organization ErrorResponse: type: object properties: error: type: string code: type: string recovery: type: string required: - error GeoSettings: type: - object - 'null' properties: id: type: string organizationId: type: string projectId: type: string companyName: type: string aliases: type: array items: type: string conversionPaths: type: array items: type: string domains: type: array items: type: string competitors: type: array items: type: string languages: type: array items: type: string engines: type: array items: type: string enforceZdr: type: boolean nonZdrApprovedEngines: type: array items: type: string trackWithoutSearch: type: boolean pausedAutoPromptIds: type: array items: type: string removedAutoPromptIds: type: array items: type: string enabled: type: boolean scanIntervalHours: type: integer scanStartedAt: type: - string - 'null' lastScanAt: type: - string - 'null' isScanning: type: boolean createdAt: type: string updatedAt: type: string required: - id - organizationId - projectId - companyName - aliases - conversionPaths - domains - competitors - languages - engines - enforceZdr - nonZdrApprovedEngines - trackWithoutSearch - pausedAutoPromptIds - removedAutoPromptIds - enabled - scanIntervalHours - scanStartedAt - lastScanAt - isScanning - createdAt - updatedAt securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: Send your API key in the Authorization header as Bearer API_KEY. ````