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

# Push a WordPress site environment



## OpenAPI

````yaml /schemas/index.yaml put /sites/{site_id}/environments
openapi: 3.1.0
info:
  title: Kinsta API
  version: 1.95.0
  description: pages/introduction.md
  termsOfService: https://kinsta.com/legal/terms-service/
  x-logo:
    url: https://kinsta-api-resources.s3.amazonaws.com/kinsta-api-logo-light.svg
    href: /
  x-meta:
    title: Kinsta API - Kinsta® Docs
    description: >-
      Kinsta's REST API provides a streamlined and efficient way to work with
      our platform, allowing you to efficiently retrieve data, perform actions,
      and automate tasks.
servers:
  - url: https://api.kinsta.com/v2
security: []
tags:
  - name: Company Users
    description: pages/company-users/description.md
  - name: Domains
    description: pages/domains/description.md
  - name: Available Regions
    description: pages/available-regions/description.md
  - name: API Keys
    description: pages/api-keys/description.md
  - name: Activity Logs
    description: pages/activity-logs/description.md
  - name: WordPress Sites
    description: pages/wordpress-sites/description.md
  - name: WordPress Site Environments
    description: pages/wordpress-site-environments/description.md
  - name: WordPress Site Tools
    description: pages/wordpress-site-tools/description.md
  - name: WordPress Site Themes & Plugins
    description: pages/wordpress-site-themes-plugins/description.md
  - name: WordPress Site Domains
    description: pages/wordpress-site-domains/description.md
  - name: WordPress Edge Caching
    description: pages/wordpress-edge-caching/description.md
  - name: WordPress CDN
    description: pages/wordpress-cdn/description.md
  - name: Backups
    description: pages/backups/description.md
  - name: Logs
    description: pages/logs/description.md
  - name: Additional SFTP Users
    description: pages/additional-sftp-users/description.md
  - name: Analytics
    description: pages/analytics/description.md
  - name: Operations
    description: pages/operations/description.md
  - name: Authentication
    description: pages/authentication/description.md
paths:
  /sites/{site_id}/environments:
    put:
      tags:
        - WordPress Site Environments
      summary: Push a WordPress site environment
      operationId: pushWordPressEnvironment
      parameters:
        - schema:
            type: string
            example: 54fb80af-576c-4fdc-ba4f-b596c83f15a1
          required: true
          name: site_id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PushEnvironmentRequestBody'
      responses:
        '202':
          description: Pushing environment action started. Check MyKinsta for status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PushEnvironmentResponse'
        '400':
          description: >-
            One or more of the required parameters were not provided to the
            request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponseSchema400'
        '401':
          description: No or invalid API key provided to the request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponseSchema401'
        '500':
          description: Error occurred while pushing an environment
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponseSchema500'
      security:
        - bearerAuth: []
components:
  schemas:
    PushEnvironmentRequestBody:
      type: object
      properties:
        source_env_id:
          type: string
          example: 54fb80af-576c-4fdc-ba4f-b596c83f15a1
        target_env_id:
          type: string
          example: 54fb80af-576c-4fdc-ba4f-b596c83f15a1
        push_db:
          type: boolean
          default: true
          example: true
        push_files:
          type: boolean
          default: true
          example: true
        run_search_and_replace:
          type: boolean
          default: true
          example: true
        push_files_option:
          type: string
          enum:
            - ALL_FILES
            - SPECIFIC_FILES
          default: ALL_FILES
          example: SPECIFIC_FILES
        file_list:
          type: array
          items:
            type: string
          example:
            - wp-content/plugins
            - wp-content/themes
            - wp-content/uploads
      required:
        - source_env_id
        - target_env_id
    PushEnvironmentResponse:
      type: object
      properties:
        operation_id:
          type: string
          example: environments:push-54fb80af-576c-4fdc-ba4f-b596c83f15a1
        message:
          type: string
          example: Pushing environment in progress
        status:
          type: number
          example: 202
      required:
        - message
        - status
    StatusResponseSchema400:
      type: object
      properties:
        message:
          type: string
          example: Bad request format
        status:
          type: number
          example: 400
        data: {}
      required:
        - message
        - status
    StatusResponseSchema401:
      type: object
      properties:
        message:
          type: string
          example: No or invalid API key provided to the request
        status:
          type: number
          example: 401
        data: {}
      required:
        - message
        - status
    StatusResponseSchema500:
      type: object
      properties:
        message:
          type: string
          example: Error occurred while processing your request
        status:
          type: number
          example: 500
        data: {}
      required:
        - message
        - status
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````