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

# Update an existing workspace



## OpenAPI

````yaml openapi.json post /api/workspaces.update
openapi: 3.0.3
info:
  title: Staminads API
  description: Web analytics platform for tracking TimeScore metrics
  version: 1.0.0
servers:
  - url: https://your-instance.example.com
    description: Your Staminads instance
security: []
paths:
  /api/workspaces.update:
    post:
      tags:
        - workspaces
      summary: Update an existing workspace
      operationId: WorkspacesController_update
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWorkspaceDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
components:
  schemas:
    UpdateWorkspaceDto:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
          enum:
            - initializing
            - active
            - inactive
            - error
        name:
          type: string
        website:
          type: string
          format: uri
        timezone:
          type: string
        currency:
          type: string
        logo_url:
          type: string
          format: uri
        settings:
          $ref: '#/components/schemas/UpdateWorkspaceSettingsDto'
      required:
        - id
    UpdateWorkspaceSettingsDto:
      type: object
      properties:
        timescore_reference:
          type: number
          minimum: 1
        bounce_threshold:
          type: number
          minimum: 1
        custom_dimensions:
          type: object
        filters:
          type: array
          items:
            type: object
        integrations:
          type: array
          items:
            type: object
        geo_enabled:
          type: boolean
        geo_store_city:
          type: boolean
        geo_store_region:
          type: boolean
        geo_coordinates_precision:
          type: number
          minimum: 0
          maximum: 2
        annotations:
          type: array
          items:
            $ref: '#/components/schemas/AnnotationDto'
        smtp:
          $ref: '#/components/schemas/SmtpSettingsUpdateDto'
        allowed_domains:
          type: array
          items:
            type: string
            maxLength: 253
            pattern: /^(\*\.)?([a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/
    AnnotationDto:
      type: object
      properties:
        id:
          type: string
        date:
          type: string
        time:
          type: string
          pattern: /^([01]\d|2[0-3]):([0-5]\d)$/
        timezone:
          type: string
        title:
          type: string
          maxLength: 100
        description:
          type: string
          maxLength: 500
        color:
          type: string
          pattern: /^#[0-9A-Fa-f]{6}$/
      required:
        - id
        - date
        - time
        - timezone
        - title
    SmtpSettingsUpdateDto:
      type: object
      properties:
        enabled:
          type: boolean
        host:
          type: string
          maxLength: 255
        port:
          type: number
          minimum: 1
          maximum: 65535
        username:
          type: string
          maxLength: 255
        password_encrypted:
          type: string
          maxLength: 255
        from_name:
          type: string
          maxLength: 100
        from_email:
          type: string
          format: email
      required:
        - enabled
        - host
        - port
        - from_name
        - from_email

````