# Bulk Update Email Account Warmup Status

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /account/bulk-update-warmup:
    patch:
      summary: Bulk Update Email Account Warmup Status
      deprecated: false
      description: >
        This endpoint allows you to modify the warmup status for multiple email
        accounts simultaneously.

        Only the warmup status field will be updated - other account settings
        remain unchanged.


        **Required Fields:**

        - `ids`: Array of email account IDs to update

        - `warmup_status`: New warmup status (ACTIVE or INACTIVE)
      tags:
        - Email Account
        - Email Accounts
      parameters:
        - name: x-api-key
          in: header
          description: Your PlusVibe.ai account's API Key
          required: false
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - workspace_id
                - ids
                - warmup_status
              properties:
                workspace_id:
                  type: string
                  pattern: ^[0-9a-fA-F]{24}$
                  description: workspace identifier
                  examples:
                    - 507f1f77bcf86cd799439011
                ids:
                  type: array
                  description: Array of email account IDs to update warmup status
                  minItems: 1
                  items:
                    type: string
                    pattern: ^[0-9a-fA-F]{24}$
                    description: email account ids
                  examples:
                    - - 507f1f77bcf86cd799439012
                      - 507f1f77bcf86cd799439013
                      - 507f1f77bcf86cd799439014
                warmup_status:
                  type: string
                  enum:
                    - ACTIVE
                    - INACTIVE
                  description: |
                    Warmup status for the email accounts:
                    - **ACTIVE**: Enable warmup process for the accounts
                    - **INACTIVE**: Disable warmup process for the accounts
                  examples:
                    - ACTIVE
              x-apidog-orders:
                - workspace_id
                - ids
                - warmup_status
            examples:
              activate_warmup:
                value:
                  workspace_id: 507f1f77bcf86cd799439011
                  ids:
                    - 507f1f77bcf86cd799439012
                    - 507f1f77bcf86cd799439013
                  warmup_status: ACTIVE
                summary: Activate warmup for multiple accounts
                description: Enable warmup process for selected email accounts
              deactivate_warmup:
                value:
                  workspace_id: 507f1f77bcf86cd799439011
                  ids:
                    - 507f1f77bcf86cd799439014
                    - 507f1f77bcf86cd799439015
                    - 507f1f77bcf86cd799439016
                  warmup_status: INACTIVE
                summary: Deactivate warmup for multiple accounts
                description: Disable warmup process for selected email accounts
              single_account:
                value:
                  workspace_id: 507f1f77bcf86cd799439011
                  ids:
                    - 507f1f77bcf86cd799439017
                  warmup_status: ACTIVE
                summary: Update warmup status for single account
                description: Change warmup status for just one email account
      responses:
        '200':
          description: Warmup status updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    examples:
                      - true
                  message:
                    type: string
                    examples:
                      - Email accounts warmup status updated successfully
                  data:
                    type: object
                    properties:
                      updated_count:
                        type: integer
                        description: Number of email accounts successfully updated
                        examples:
                          - 3
                      updated_ids:
                        type: array
                        description: >-
                          Array of email account IDs that were successfully
                          updated
                        items:
                          type: string
                        examples:
                          - - 507f1f77bcf86cd799439012
                            - 507f1f77bcf86cd799439013
                            - 507f1f77bcf86cd799439014
                    x-apidog-orders:
                      - updated_count
                      - updated_ids
                x-apidog-orders:
                  - success
                  - message
                  - data
              example:
                success: true
                message: Email accounts warmup status updated successfully
                data:
                  updated_count: 3
                  updated_ids:
                    - 507f1f77bcf86cd799439012
                    - 507f1f77bcf86cd799439013
                    - 507f1f77bcf86cd799439014
          headers: {}
          x-apidog-name: OK
        '400':
          description: Bad Request - Validation Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    examples:
                      - false
                  message:
                    type: string
                    examples:
                      - Validation Error
                  error:
                    type: string
                    examples:
                      - Validation Error
                  errors:
                    type: array
                    items:
                      type: string
                    description: Array of specific validation error messages
                x-apidog-orders:
                  - success
                  - message
                  - error
                  - errors
              examples:
                '2':
                  summary: Missing required fields
                  value:
                    success: false
                    message: Validation Error
                    error: Validation Error
                    errors:
                      - '"ids" is required'
                      - '"warmup_status" is required'
                '3':
                  summary: Invalid warmup status value
                  value:
                    success: false
                    message: Validation Error
                    error: Validation Error
                    errors:
                      - '"warmup_status" must be one of [ACTIVE, INACTIVE]'
                '4':
                  summary: Invalid ID format
                  value:
                    success: false
                    message: Validation Error
                    error: Validation Error
                    errors:
                      - '"ids[0]" length must be 24 characters long'
                      - '"workspace_id" must only contain hexadecimal characters'
                '5':
                  summary: Empty IDs array
                  value:
                    success: false
                    message: Validation Error
                    error: Validation Error
                    errors:
                      - '"ids" must contain at least 1 items'
          headers: {}
          x-apidog-name: Bad Request
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    examples:
                      - false
                  message:
                    type: string
                    examples:
                      - Unauthorized access
                  error:
                    type: string
                    examples:
                      - Invalid API key
                x-apidog-orders:
                  - success
                  - message
                  - error
              examples:
                '6':
                  summary: Missing API key
                  value:
                    success: false
                    message: Unauthorized access
                    error: API key is required
                '7':
                  summary: Invalid API key
                  value:
                    success: false
                    message: Unauthorized access
                    error: Invalid API key
          headers: {}
          x-apidog-name: Unauthorized
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    examples:
                      - false
                  message:
                    type: string
                    examples:
                      - Internal server error
                  error:
                    type: string
                    examples:
                      - Database connection failed
                x-apidog-orders:
                  - success
                  - message
                  - error
              example:
                success: false
                message: Internal server error
                error: An unexpected error occurred while processing the request
          headers: {}
          x-apidog-name: Server Error
      security: []
      x-apidog-folder: Email Account
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/929054/apis/api-21393152-run
components:
  schemas: {}
  securitySchemes:
    ApiKeyAuth:
      type: apikey
      in: header
      name: x-api-key
      description: |
        API key issued in the PlusVibe dashboard. The server reads it
        from the `x-api-key` header and injects it into the request as
        the `api_key` query parameter, which is why you will see
        `api_key` referenced in validation errors.
    apiKey:
      type: apikey
      in: body
      name: api_key
      description: API key passed in request body
servers:
  - url: https://api.plusvibe.ai/api/v1
    description: Prod Env
security:
  - ApiKeyAuth: []
    x-apidog:
      schemeGroups:
        - id: uS5KiuC4wfZHK42AzOfA_
          schemeIds:
            - ApiKeyAuth
      required: true
      use:
        id: uS5KiuC4wfZHK42AzOfA_
      scopes:
        uS5KiuC4wfZHK42AzOfA_:
          ApiKeyAuth: []

```