> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evermind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update memory space settings

> Update the global settings, or initialize them if they don't exist yet. Only provided fields are updated; omitted fields retain their current values.



## OpenAPI

````yaml /api-reference/openapi.json put /api/v1/settings
openapi: 3.1.0
info:
  title: EverOS API
  description: >-
    Enterprise-grade intelligent memory system for AI agents. Extracts,
    structures, and retrieves information from conversations.
  version: 1.0.0
  contact:
    name: EverOS Team
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
  - url: https://api.evermind.ai
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Memories
    description: Memory ingestion, retrieval, search, and deletion
  - name: Groups
    description: Group resource CRUD operations
  - name: Senders
    description: Sender resource CRUD operations
  - name: Settings
    description: Global settings management
  - name: Tasks
    description: Async task status tracking
  - name: Storage
    description: Multimodal content storage (pre-signed upload)
paths:
  /api/v1/settings:
    put:
      tags:
        - Settings
      summary: Update memory space settings
      description: >-
        Update the global settings, or initialize them if they don't exist yet.
        Only provided fields are updated; omitted fields retain their current
        values.
      operationId: updateSettings
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSettingsRequest'
      responses:
        '200':
          description: Settings updated/initialized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettingsApiResponse'
        '422':
          description: Validation error (invalid parameter values)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: Python
          source: |-
            from everos_cloud import EverOS

            client = EverOS()
            settings = client.v1.settings

            response = settings.update(
                timezone="<string>",
                extraction_mode="<string>"
            )
            print(response)
        - lang: cURL
          source: |-
            curl --request PUT \
              --url 'https://api.evermind.ai/api/v1/settings' \
              --header 'Authorization: Bearer <api_key>' \
              --header 'Content-Type: application/json' \
              --data '{}'
components:
  schemas:
    UpdateSettingsRequest:
      type: object
      properties:
        llm_custom_setting:
          description: LLM custom settings for algorithm control
          oneOf:
            - $ref: '#/components/schemas/LlmCustomSetting'
            - type: 'null'
        timezone:
          description: IANA timezone identifier
          examples:
            - UTC
            - Asia/Shanghai
          type:
            - string
            - 'null'
    SettingsApiResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/SettingsResponse'
    ErrorResponse:
      type: object
      required:
        - code
        - message
        - timestamp
        - path
      properties:
        code:
          type: string
          description: Error code
          examples:
            - InvalidParameter
            - NotFound
            - InternalError
        message:
          type: string
          description: Error message
        request_id:
          type: string
          description: Request ID
          default: unknown
        timestamp:
          type: string
          description: ISO 8601 timestamp
        path:
          type: string
          description: Request path
    LlmCustomSetting:
      type: object
      properties:
        boundary:
          description: LLM config for boundary detection (fast, cheap model recommended)
          oneOf:
            - $ref: '#/components/schemas/LlmProviderConfig'
            - type: 'null'
        extraction:
          description: LLM config for memory extraction (high quality model recommended)
          oneOf:
            - $ref: '#/components/schemas/LlmProviderConfig'
            - type: 'null'
    SettingsResponse:
      type: object
      required:
        - timezone
        - created_at
        - updated_at
      properties:
        llm_custom_setting:
          description: LLM custom settings (serialized)
          additionalProperties: true
          type:
            - object
            - 'null'
        timezone:
          type: string
          description: IANA timezone identifier
        created_at:
          type: string
          description: Creation time (ISO 8601)
        updated_at:
          type: string
          description: Last update time (ISO 8601)
    LlmProviderConfig:
      type: object
      required:
        - provider
        - model
      properties:
        provider:
          type: string
          description: LLM provider name
          enum:
            - openrouter
          default: openrouter
        model:
          type: string
          description: Model identifier
          enum:
            - qwen3-235b-a22b-2507
            - gpt-4.1-mini
          default: qwen3-235b-a22b-2507
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      x-default: Bearer <api_key>
      description: >-
        Bearer authentication header of the form Bearer 'api_key', obtain your
        API key from [everos.evermind.ai](https://everos.evermind.ai).

````