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

# Create

> Create secret imports



## OpenAPI

````yaml POST /api/v2/secret-imports
openapi: 3.0.3
info:
  title: Infisical API
  description: List of all available APIs that can be consumed
  version: 0.0.1
servers:
  - url: https://us.infisical.com
    description: Production server (US)
  - url: https://eu.infisical.com
    description: Production server (EU)
  - url: http://localhost:8080
    description: Local server
security: []
paths:
  /api/v2/secret-imports:
    post:
      tags:
        - Secret Imports
      description: Create secret imports
      operationId: createSecretImport
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                projectId:
                  type: string
                  description: The ID of the project you are working in.
                environment:
                  type: string
                  description: The slug of the environment to import into.
                path:
                  type: string
                  default: /
                  description: The path to import into.
                import:
                  type: object
                  properties:
                    environment:
                      type: string
                      description: The slug of the environment to import from.
                    path:
                      type: string
                      description: The path to import from.
                  required:
                    - environment
                    - path
                  additionalProperties: false
                isReplication:
                  type: boolean
                  default: false
                  description: >-
                    When true, secrets from the source will be automatically
                    sent to the destination. If approval policies exist at the
                    destination, the secrets will be sent as approval requests
                    instead of being applied immediately.
              required:
                - projectId
                - environment
                - import
              additionalProperties: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  secretImport:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      version:
                        type: number
                        default: 1
                        nullable: true
                      importPath:
                        type: string
                      position:
                        type: number
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
                      folderId:
                        type: string
                        format: uuid
                      isReplication:
                        type: boolean
                        default: false
                        nullable: true
                      isReplicationSuccess:
                        type: boolean
                        nullable: true
                      replicationStatus:
                        type: string
                        nullable: true
                      lastReplicated:
                        type: string
                        format: date-time
                        nullable: true
                      isReserved:
                        type: boolean
                        default: false
                        nullable: true
                      importEnv:
                        type: object
                        properties:
                          name:
                            type: string
                          slug:
                            type: string
                          id:
                            type: string
                        required:
                          - name
                          - slug
                          - id
                        additionalProperties: false
                    required:
                      - id
                      - importPath
                      - position
                      - createdAt
                      - updatedAt
                      - folderId
                      - importEnv
                    additionalProperties: false
                required:
                  - message
                  - secretImport
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 400
                  message:
                    type: string
                  error:
                    type: string
                  details: {}
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 401
                  message:
                    type: string
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 403
                  message:
                    type: string
                  details: {}
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 404
                  message:
                    type: string
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 422
                  message: {}
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - error
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 500
                  message:
                    type: string
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: An access token in Infisical

````